Skip to content

A Customizable Minecraft server run entirely on Linux!

License

Notifications You must be signed in to change notification settings

entity12208/Minecraft-Server

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

58 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Customizable Minecraft Server

License: MIT Minecraft Version Stars

A Linux-based Minecraft server setup script, designed for modded gameplay with performance and quality-of-life enhancements. Perfect for those who want a fully customizable Minecraft server experience.


⚡ Features

  • Mod Support: Pre-configured with popular SMP mods like Origins, REI, and Better Combat.
  • Performance Optimized: Includes Lithium, Starlight, and FerriteCore for smooth gameplay.
  • Automated Backups: Daily backups to ensure your world is safe.
  • Whitelist Management: Easily control server access with a whitelist.
  • Cross-Platform Ready: Add GeyserMC for Bedrock support.
  • One-Time Setup: Simplified installation process with minimal manual configurations.

📋 Prerequisites

Before setting up the server, ensure your Linux system has the following:

  • Java 21: OpenJDK 21 or equivalent.
  • screen: To run the server in the background.
  • curl and unzip: For downloading and extracting files.

Install Dependencies

Run the following command to install all necessary dependencies:

sudo apt update && sudo apt install -y openjdk-21-jre-headless screen curl unzip

🚀 Setup Instructions

  1. Clone this repository:

    git clone https://github.com/entity12208/Fabric-Server.git
    cd Fabric-Server
  2. Make the setup script executable and run it:

    chmod +x setup-fabric-server-full.sh
    ./setup-fabric-server-full.sh

    This will download and configure the necessary server files and folders.

  3. Important:

    • The setup script is one-time use. Re-running it may overwrite your existing server files.

▶️ Starting the Server

Run the server using:

./start-server.sh

This will launch the server console in your terminal.


🔄 Updating Mods

To update all installed mods, use the provided script:

chmod +x update-mods.sh
./update-mods.sh

🗄️ Backups

  • Automated daily backups are created at 3 AM.
  • To manually create a backup, run:
    ./backup.sh

🔒 Whitelist Management

To control who can join the server:

  1. Add player usernames and UUIDs to whitelist.json. You can find your UUID at MinecraftUUID.com.
  2. For a public server, disable the whitelist by editing server.properties:
    white-list=false

🛠️ Adding Mods

  • To customize the mods:
    • Edit the SMPMODS array in setup-fabric-server-full.sh or update-mods.sh to include mod URLs.
  • Alternatively, add .jar files directly to the mods folder.

❓ Troubleshooting

  • Server Crashes: The server auto-restarts. Check logs/latest.log for details.
  • Port Forwarding: Ensure port 25565 is open on your router.
  • Whitelist Issues: Verify usernames and UUIDs in whitelist.json.

📄 Additional Notes

  • Java Edition Only: This setup is exclusively for Java Edition. For Bedrock support, add GeyserMC.
  • 24/7 Uptime: Recommended hardware includes Raspberry Pi 5 or equivalent.
  • Regular Updates: Keep mods and server files up-to-date for the best performance and experience.

🤝 Contributing

Contributions are welcome! Please review the CONTRIBUTING.md guidelines before submitting your pull requests.


📜 License

This project is licensed under the MIT License.


💬 Support

For questions or issues, feel free to open an issue or contact the repository maintainer.


Enjoy your fully customizable Minecraft server!

About

A Customizable Minecraft server run entirely on Linux!

Topics

Resources

License

Stars

Watchers

Forks

Languages