Skip to content

Euphillya/Skyllia

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

831 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Skyllia

The first Skyblock plugin fully compatible with Folia

Folia Paper Java License

Documentation โ€ข GitHub โ€ข Modrinth โ€ข Discord

Servers & Players


๐Ÿ“– About

Skyllia is a modern, high-performance Skyblock plugin, designed from the ground up to fully leverage the multi-threaded architecture of Folia. The first of its kind to offer native Folia compatibility, Skyllia delivers exceptional performance even with hundreds of simultaneous players.

โœจ Key Features

๐Ÿš€ Performance & Architecture

  • First Folia-compatible Skyblock plugin โ€” Native multi-threaded architecture
  • Asynchronous system โ€” No freezes, no lag (as long as your server configuration allows)

๐Ÿ’พ Data Management

  • Database support โ€” SQLite, MariaDB, PostgreSQL
  • HikariCP connection pool โ€” Optimal performance
  • Asynchronous saving โ€” Zero performance impact

๐Ÿ๏ธ Island Management

  • Instant creation โ€” Optimized queue system
  • Customizable schematics โ€” WorldEdit/FAWE or built-in system
  • Multi-world โ€” Overworld, Nether, End all configurable
  • Automatic portals โ€” Smooth navigation between dimensions
  • Configurable spacing โ€” Adjustable distance between islands

๐Ÿ‘ฅ Permission System

  • 6 predefined roles โ€” Owner, Co-Owner, Moderator, Member, Visitor, Ban
  • 50+ granular permissions โ€” Full control per role
  • Temporary trust โ€” Configurable guest access
  • Modular system โ€” Create your own roles

๐ŸŽฏ Advanced Features

  • Island warps โ€” Quick teleportation to your island
  • Customizable biomes โ€” Change the atmosphere of your island
  • Per-island game rules โ€” PvP, mobs, explosions, etc.
  • Ban system โ€” Ban griefers from your island
  • Invitations โ€” Invitation system with expiry

๐Ÿ”Œ Integrations

  • PlaceholderAPI โ€” Variables for scoreboard, tab, etc.
  • Vault โ€” Economy support (via SkylliaBank)
  • WorldEdit/FAWE โ€” High-performance schematics
  • Insights โ€” Block limits (via InsightsSkyllia)

๐ŸŽฎ Official Addons

Extend Skyllia with 5 free official addons:

Addon Description
SkylliaBank Shared island bank system with transaction history
SkylliaOre Configurable automatic ore generator
SkylliaChallenge Daily/weekly challenges with rewards
SkylliaChat Per-island chat with multiple channels
InsightsSkyllia Block and entity limits per island

๐Ÿ“‹ Requirements

  • Server: Folia 1.20.6+ or Paper 1.20.6+
  • Java: 21 or higher
  • RAM: 4GB minimum, 8GB+ recommended
  • Database (optional): MariaDB 10.5+ or PostgreSQL 12+ (prefer PostgreSQL for large servers)

Compatible plugins (optional)

  • WorldEdit or FastAsyncWorldEdit (recommended)
  • Vault (for SkylliaBank)
  • PlaceholderAPI (for placeholders)
  • LuckPerms (for server permissions)

๐Ÿš€ Quick Installation

  1. Download Skyllia from Modrinth or GitHub Releases
  2. Place the .jar in plugins/
  3. Start the server (first initialization)
  4. Configure in plugins/Skyllia/config/
  5. Restart and you're good to go!

Minimal Configuration

# config.toml
[settings.island]
region-distance = 10  # 5120 blocks between islands, 1 region = 512x512
max-islands = 500_000

# database.toml - SQLite by default
[sqlite]
enabled = true

For a full installation guide, check the documentation.

๐Ÿ“š Documentation

Full documentation is available on GitBook:

๐Ÿ”— skyllia.euphyllia.moe

๐Ÿ’ป For Developers

Skyllia provides a complete API to create your own addons:

<!-- Maven -->
<repository>
    <id>euphyllia-repo</id>
    <url>https://repo.euphyllia.moe/repository/maven-public/</url>
</repository>

<dependency>
<groupId>fr.euphyllia.skyllia</groupId>
<artifactId>api</artifactId>
<version>3.x</version>
<scope>provided</scope>
</dependency>
import fr.euphyllia.skyllia.api.SkylliaAPI;
import fr.euphyllia.skyllia.api.island.Island;
import org.bukkit.entity.Player;

Island island = SkylliaAPI.getIslandByPlayerId(player.getUniqueId());
if(island != null){
   player.sendMessage("Your island: "+ island.getId());
}

See the API documentation for more information.

๐ŸŽฏ Main Commands

Players

/island create <type>    - Create an island
/island home             - Teleport to your island
/island invite <player>  - Invite a player
/island delete           - Delete your island
/island biome <biome>    - Change the biome
/island expel <player>   - Expel a visitor

Administrators

/isadmin reload              - Reload configs
/isadmin setsize <player> <size> - Modify island size
/isadmin teleport <player>   - TP to a player's island

Full list: Player commands โ€ข Admin commands

๐Ÿค Contributing

Skyllia is open source, you can contribute via:

  • Bug reports โ€” GitHub Issues
  • Suggestions โ€” Discord or GitHub Discussions
  • Community addons โ€” Share your creations!

๐Ÿ“ž Support

๐Ÿ“œ License

Skyllia is licensed under the MIT License. For more details, see the LICENSE file in the GitHub repository.