Content generated with AI — it may contain mistakes.

ExyliaShields/HelpUpdated in v1.5.0

Troubleshooting

Fixes for the usual problems: the plugin does not start, patterns are locked, designs vanish, the shop is empty.

Page 14 of 202 min read

The plugin does not start#

packetevents is required. Without it the server disables ExyliaShields and says why in the console. Install it, then restart. ExyliaLib is not a hard requirement, but without it the crate, the shop and the /exylialib commands are missing.

Players see every pattern locked#

A normal player owns nothing at first. Give your default group a palette, or let them win one: see Sell slots, layers and colours. Operators always see everything unlocked, so test with a non-op account.

A player is told "Your rank does not include this"#

They lack one of exyliashields.command.shields, exyliashields.browser or exyliashields.crate. Everybody holds those by default, so a group or another plugin is denying one. Check with your permission plugin. See Permissions.

A player has only one slot#

One slot is the default. Grant exyliashields.max_slots.<n> to the ranks that should have more.

Designs disappear from shields#

This is force_system, on by default: a player without exyliashields.use has the design removed whenever they equip a shield. Grant the node, or set force_system: false in config.yml and run /shieldsadmin reload. It also happens in a world listed under disabled-worlds, where shields show plain until the player leaves it.

A design vanished when the shield broke#

It should not. The design is stored on the player, not on the item. If a new shield stays plain, check exyliashields.use and that the slot is still the active one (/shields, right-click the slot).

An imported design looks different#

An import is drawn with the importer's own palette. A layer using a pattern they do not own is not a way around locking.

The shop shows nothing for sale#

It needs ExyliaEconomy or Vault, shop.enabled: true, and a price for the entry's rarity under shop.tier-prices (or on the entry). Without all three a locked row stays locked. See The crate and the shop.

The crate does nothing#

Check crate.enabled, that the player has keys (/shieldsadmin keys <player>), and that the crate is not already open. Staff can give keys with /shieldsadmin keys give <player> <amount>.

A player gets the inventory menu instead of the 3D one#

The 3D menus need a 1.21.4 or newer client, and PacketEvents on the server. Older clients get the inventory menus. See 3D menus.

Reset one player#

/exylialib resetplayer <player> ExyliaShields deletes their slots, library designs, keys and unlocks. See ExyliaLib's commands.

Still stuck? Ask on the Exylia Discord.

Something missing on this page? Tell us on Discord