FugCraft Server

🎮 Plug and Play Minecraft Server (Vanilla+)

---

🎯 For Players

Joining the server? Check out the Client Resources for everything you need to get started!

• 📦 Custom modpack
• 🎨 Curated resource packs
• ✨ Optimized shader recommendations
• ⚙️ Easy setup guide

---

🚀 For Server Hosts

Want to run your own FugCraft server? This repository contains everything you need!

📥 Quick Setup

Prerequisites: You need Java 21 (recommended) or Java 17+ installed:

• Download Java 21 (recommended)
• Java 17+ will also work if you already have it installed

1. Clone this repository:

   git clone https://github.com/FugLong/FugCraft-Server.git
   cd FugCraft-Server

2. Start the server:

   • Windows: Run start-server.bat
   • Linux/Mac: Run ./start-server.sh

3. Configure your server:

   • Edit server.properties for basic settings
   • Modify config files in config/ as needed
   • Highly recommended to delete HoloDisplays config
   • Set up LuckPerms permissions (see guide below)

⚙️ RAM Configuration

Important: You may need to adjust RAM allocation based on your system!

The startup scripts use these default values:

• Minimum RAM: 4G (4 GB)
• Maximum RAM: 12G (12 GB)

🔧 How to Change RAM:

In start-server.bat (Windows):

-Xms4G -Xmx12G

In start-server.sh (Linux/Mac):

-Xms4G -Xmx12G

📊 Recommended RAM Settings:

System RAM	Min (-Xms)	Max (-Xmx)	Notes
8 GB	2G	6G	Minimum viable
16 GB	4G	8G	Good performance
32 GB	6G	16G	High performance
64 GB+	8G	24G	Maximum performance

💡 Example:

For a 8GB system:

-Xms2G -Xmx6G

📁 What's Included

• ✅ Server JAR - Fabric server launcher
• ✅ Mods - All required server mods
• ✅ Configs - Pre-configured mod settings
• ✅ Startup Scripts - Cross-platform launchers
• ✅ LuckPerms - Permission system (groups/tracks only)

📋 Server Mod List

💡 Tip: You can disable any mod by renaming its .jar file to .jar.disabled in the /mods folder (e.g., remorphed.jar → remorphed.jar.disabled)

The server includes these mods (Fabric 1.21.8):

Core & Performance:

• Fabric API - Core Fabric functionality
• Lithium - Server-side performance optimizations
• VMP - Optimizations for handling many players at once
• C2ME - Chunk loading optimizations
• Noisium - Performance improvements
• Alternate Current - Redstone optimizations
• ScalableLux - Lighting optimization

Server Management:

• LuckPerms - Permission system
• LuckPerms Placeholder API Hook - PlaceholderAPI integration for LuckPerms
• Essential Commands - Essential server commands
• Auto Restart - Automatic server restarts
• Advanced Backups - Server backup system
• ServerLinksSender - Custom server links in pause menu
• AntiXray - Prevents players from using xray mods or resource packs effectively
• StarterKit - Controls what items new players receive on first join
• Vanish - Allows admins to hide their presence on the server
• Old School Jail - Allows admins and mods to jail players
• Spark - Server performance profiling and monitoring

Gameplay Features:

• Open Parties and Claims - Land claiming system
• Inventory Sorter - Automatic inventory sorting
• Falling Tree - Tree chopping mechanics
• KleeSlabs - Slab breaking mechanics
• Graves - Death chest system
• Pet Protect - Pet protection
• Pet Teleport Fix - Pet teleportation fixes
• Anvil Restoration - Anvil repair mechanics (right-click anvil with iron to repair)
• ReMorphed - Transform into mobs/players after killing them
• PuppetPlayers - Fake players for testing
• Sit! - Sitting mechanics

Cross-Platform:

• Geyser - Bedrock edition support
• Floodgate - Bedrock authentication
• Fabric Permissions API - Permission system API
• Vanilla Permissions - Vanilla permission support

Visual & Client Features:

• Distant Horizons - Extended render distance
• Jade - Block/entity information display
• Styled Chat - Enhanced chat system
• Styled Player List - Enhanced player list
• HoloDisplays - Hologram display system
• Sound Physics Remastered - Realistic sound propagation and reverb

Utilities:

• Mod Menu - In-game mod configuration
• Cloth Config - Configuration framework
• Forge Config API Port - Configuration compatibility
• Collective - Library mod
• CraftedCore - Core functionality
• Balm - Library mod
• OtterLib - Library mod (dependency)
• Lithostitched - Lithium compatibility
• InvView - Inventory viewing
• WorldEdit - World editing tools
• ChoiceTheorem's Overhauled Village - Enhanced village generation and structures
• Explorify - Adds new vanilla-friendly structures to world generation
• Walkers - Mob transformation library (dependency)
• SkinShifter - Skin changing library (dependency)
• Fabric Language Kotlin - Kotlin language support library

Voice Chat:

• Voice Chat - Proximity-based voice chat system
• VCInteraction - Voice chat interaction features

👥 LuckPerms Permission Setup

The server comes with pre-configured permission groups and tracks. Here's how to give yourself admin access:

Quick Setup - Give Yourself Owner Permissions:

Option 1: Using Console Command

1. Join your server
2. Open the server console
3. Run: lp user <your-username> permission set luckperms.* true
4. Now you can use all LuckPerms commands in-game

Option 2: Using LuckPerms Editor (Easier)

1. In server console, run: lp editor
2. Click the link that appears in console
3. In the web editor, go to Users → find your username
4. Give yourself the owner group
5. Save and close

Available Groups:

These groups build on one another - each level includes all permissions from lower groups plus additional ones.

• default (guest) - New players (basic permissions)

  • Can set 1 home, basic commands only, claim 32 chunks max

• member - Regular players

  • Can set 3 homes, access to warps + more commands, can use ReMorphed mod (no flying mobs), claim 64 chunks max

• citizen - Trusted players

  • Can set 5 homes, can nickname themselves, basic flying and lava walking mobs in ReMorphed, claim 128 chunks max

• moderator - Staff members

  • Can set 10 homes, can kick players, can TP without requesting, more mod commands, special ReMorphed forms like ender dragon, claim 256 chunks max

• veteran - Long-time players

  • Like moderators but can set 20 homes, access to cheaty commands like /anvil, /enderchest, /feed

• admin - Administrators

  • Can set 25 homes, /ban, /ban-ip, /fly, /heal, /repair, /invuln, `/vanish', can set/delete warps and spawn, claim 512 chunks max

• coowner - Co-owners

  • Admins with infinite homes, can see vanished players

• owner - Server owner

  • Access to all commands, can claim 1024 chunks max

Note: This is a general overview. Check the LuckPerms editor to see and edit all specific permissions for each group.

Need More Help?

• LuckPerms Documentation - Complete guide
• Permission files are in: mods/luckperms/yaml-storage/

🔒 Security Notes

This repository excludes sensitive data:

• Player data and inventories
• Server logs and IPs
• Player permissions assignments
• World data (backup elsewhere)

---

Enjoy your FugCraft experience! 🎮