Common Questions

❓ General

Does ArenaLegends support Minecraft 1.8?

No. The plugin is specifically designed for the latest modern versions of Minecraft. The target platform is Paper 1.21.11. Supporting 1.8 would require maintaining a separate codebase due to vast differences in the API and game mechanics (e.g., custom attributes, new entities).

Can I run this alongside other minigames?

It is highly recommended to run ArenaLegends on a dedicated server instance (BungeeCord or Velocity setup).

While it can run alongside other plugins, conflicting game managers or world protection plugins (like WorldGuard) might interfere with the plugin's game logic, map loading, or permissions.

🛠️ Troubleshooting & Setup

My arena schematics aren't loading!

1. Ensure you are using FastAsyncWorldEdit (FAWE). Standard WorldEdit is not supported.

2. Make sure you follow the strict naming convention:

   • Lobby: al_lobby_<name>

   • Arena: al_arena_<name>

3. Ensure the schematic files are correctly placed in the FAWE schematics folder (/plugins/FastAsyncWorldEdit/schematics/).

The plugin won't start (Missing Dependency)

ArenaLegends has mandatory dependencies. If any are missing or disabled, the plugin will automatically disable itself.

Mandatory Dependencies:

• PacketEvents

• Citizens2

• FastAsyncWorldEdit (FAWE)

Players can't open the shop or use items.

This is usually a permission issue. Ensure players have the following base permissions:

• arenalegends.menu.* (to open menus)

• arenalegends.item.* (to buy items)

See the Permissions page for a full list of required permissions.

The Shopkeeper NPC isn't spawning.

1. Check if you have Citizens installed and working correctly.

2. Verify your Lobby Schematic contains the [LOCATION] SHOPKEEPER sign.

3. Try removing the game and re-creating it to force a schematic paste and NPC spawn.

Make sure to check the server console for any Citizens-related errors during startup.

🎮 Gameplay

Why are textures pink or missing?

This indicates that the Resource Pack failed to load for the client.

1. Check your config.yml under the resource-pack section.

2. Ensure the download-url is a direct link (it must end in .zip).

3. If you updated the pack, you must update the sha-1-hash in the config, or clients will continue using the old cached version.

Custom items (ItemsAdder) aren't showing.

If you are using ItemsAdder, ensure that:

1. ItemsAdder is installed and completely loaded before ArenaLegends.

2. Your item configuration uses custom: "namespace:id" correctly.

3. There are no typos in the namespace or ID.

Anti-Cheat keeps flagging players.

ArenaLegends utilizes custom attributes for movement speed, attack range, and knockback, which can trigger strict anti-cheat rules.

Solution: Disable checks for Speed, Reach, and Velocity in your anti-cheat specifically for the arena worlds, or adjust its configuration to be more lenient during games.