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:

- Admin tools: Create, delete, load, and view resource pack info using `/rp_swx`. - Admin tools: Players can enable automatic resource pack loading when joining the server with `/rp_swx joinrp`. - Admin tools: Supports Russian and English with language switching via `/rp_swx lang`. - Admin tools: Messages and help menus use colored text for clarity (purple for commands, white for separators, pink for descriptions). - Admin tools: 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. Configure (optional): - Get the latest `AlluminiumResource.jar` from Modrinth. 2. Configure (optional): - Place `AlluminiumResource.jar` in your server's `plugins` folder (Paper/Purpur 1.21.1). 3. Configure (optional): - 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

- Can’t use `/rp_swx admin_delete`? - Verify the URL is correct and accessible. - Can’t use `/rp_swx admin_delete`? - Use `/rp_swx lang` to switch. - Can’t use `/rp_swx admin_delete`? - Confirm you have `swx.resourcepack` permission or OP status.