📖 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 permission

🎯 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 SkylliaInsights)

🎮 Official Addons

Extend Skyllia with 7 free official addons:

📋 Requirements

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

Compatible plugins (optional)

• WorldEdit (recommended) or FastAsyncWorldEdit
• Vault (for SkylliaBank)
• PlaceholderAPI (for placeholders)
• LuckPerms (for server permissions)
• QuickShop-Hikari (for shop island)

🚀 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;
import org.bukkit.event.EventHandler;
import org.bukkit.event.player.PlayerJoinEvent;
import org.bukkit.event.Listener;

public class MyPlugin implements Listener {

    @EventHandler
    public void onPlayerJoin(PlayerJoinEvent event) {
        Player player = event.getPlayer();
        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

🤝 Contributing

Skyllia is open source, you can contribute via:

• Bug reports — GitHub Issues
• Suggestions — Discord or GitHub Discussions
• Community addons — Share your creations!

📞 Support

• GitHub: Euphillya/Skyllia
• Issues: Report a bug
• Discord: Euphyllia Server

📜 License

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