SWX_Resources

About

SWXResource is a convenient plugin for managing resource packs on Minecraft servers running Paper/Purpur 1.21.1. It allows admins and players to easily create, upload, delete, and manage resource packs using simple commands. The plugin supports localization (Russian and English), automatic resource pack loading upon joining, and colored message formatting.

Key Features:

• Resource pack management via commands: Create, delete, load, and view resource pack info using /rp_swx.
• Auto-load on join: Players can enable automatic resource pack loading when joining the server with /rp_swx joinrp.
• Localization: Supports Russian and English with language switching via /rp_swx lang.
• Colored formatting: Messages and help menus use colored text for clarity (purple for commands, white for separators, pink for descriptions).
• Size limit: Restricts resource pack size (default: 50 MB, configurable in config.json).
• Admin tools: Admins can delete any resource pack with /rp_swx admin_delete.

Commands & Permissions:

• /rp_swx create <url> <name> — Creates a new resource pack (players only).
• /rp_swx list — Lists available resource packs.
• /rp_swx delete <name> — Deletes your resource pack (creator only).
• /rp_swx admin_delete <name> — Deletes any resource pack (requires swx.resourcepack permission or OP).
• /rp_swx dw <name> — Forces a resource pack download as a server pack (players only).
• /rp_swx info <name> — Shows resource pack details.
• /rp_swx lang <ru|eng> — Changes the plugin's language.
• /rp_swx joinrp <name> — Toggles auto-loading a pack on join (players only).
• /rp_swx help — Displays command help.

Permissions:

• swx.resourcepack — Grants access to /rp_swx admin_delete.

Compatibility:

• Server: Paper/Purpur 1.21.1.
• Dependencies: Kotlin stdlib, kotlinx-serialization-json, Adventure API. (No manual installation needed!)

Installation & Usage Guide

Below is a detailed guide for users, suitable for Modrinth or a README.md file.

Installation

1. Download the plugin:
   • Get the latest AlluminiumResource.jar from Modrinth.
2. Install the plugin:
   • Place AlluminiumResource.jar in your server's plugins folder (Paper/Purpur 1.21.1).
3. Restart the server:
   • The plugin will generate a AlluminiumResource/SWX_Resourcexpack folder with config files.
4. Configure (optional):
   • Edit SWX_Resourcexpack/config.json:
     • language — Default language (eng or ru).

Usage

1. Creating a resource pack:

   • Use /rp_swx create <url> <name>, where:
     • <url> — Direct download link to a .zip file (e.g., Google Drive/Dropbox).
     • <name> — Resource pack name.
   • Example: /rp_swx create https://example.com/pack.zip MyPack
   • The pack will be saved in the plugin’s database.

2. Listing packs:

   • Run /rp_swx list to view all available packs.
   • Format: <name> (<creator>).

3. Loading a pack:

   • Use /rp_swx dw <name> to force a download.
   • Example: /rp_swx dw MyPack
   • Players will see Minecraft’s server pack prompt.

4. Auto-load on join:

   • Run /rp_swx joinrp <name> to toggle auto-loading.
   • Example: /rp_swx joinrp MyPack
   • Repeating the command disables auto-load.

5. Deleting packs:

   • Players: /rp_swx delete <name> (your packs only).
   • Admins: /rp_swx admin_delete <name> (any pack).

6. Viewing info:

   • Use /rp_swx info <name> to see creator, creation date, and URL.

7. Changing language:

   • Run /rp_swx lang <ru|eng>.
   • Example: /rp_swx lang ru

8. Help menu:

   • Type /rp_swx help for a command summary.

Notes

• Ensure resource pack URLs point directly to .zip files (no download pages).
• If a pack fails to load, check Minecraft’s latest.log for errors (e.g., invalid URL or size limit).
• Admins: Use permission plugins (e.g., LuckPerms) to manage /rp_swx admin_delete access.

Troubleshooting

• Pack won’t load?
  • Verify the URL is correct and accessible.
• Wrong language?
  • Use /rp_swx lang to switch.
• Can’t use /rp_swx admin_delete?
  • Confirm you have swx.resourcepack permission or OP status.