?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacksServers
Settings
Moreeffect

Moreeffect

Cosmetic particle plugin adding persistent effects to items and players, with GUI, presets, preview, and performance optimization for Minecraft 1.21.x.

1
1
1
1

Compatibility

Minecraft: Java Edition

1.21.x

Platforms

Links

View source Join Discord server
Donate on PayPalDonate

Tags

Creators

Details

Licensed Apache-2.0
Published 2 days ago

DESCRIPTION:

Moreeffect is a visual effects plugin for Minecraft 1.21.x focused on three main goals:

  • Adding persistent particle effects to held items.
  • Adding persistent particle effects directly to players.
  • Giving server staff and players an easy system to preview, save, load, import, export, and manage custom particle presets.

The plugin is designed for servers that want cosmetic particle effects without forcing players to edit configs by hand. It supports multiple geometric layouts, themed dashboards, static effect rendering, language files, preset tools, and built-in maintenance utilities.

HOW IT WORKS?

  • Admins can attach particle effects to the item a player is holding by using /me item add, /me item set, and /me item clear.
  • Admins can attach particle effects directly to players by using /me player add, /me player set, and /me player clear.
  • Infused items can show a bright red Moreeffect lore line so players can see which effect and shape are embedded.
  • Players can hide that lore line with /me item flag hide.
  • Players can choose whether item-based effects are read from the main hand or off hand with /me item hand main|off.
  • Held-item effects only render while the infused item is actually being held.
  • Player effects stay active on the player until they are removed or replaced.
  • Effects can be previewed before applying them with /me preview.
  • Presets can be saved, loaded, exported, and imported for faster setup.
  • The dashboard GUI lets players browse particles, search by theme or tag, and use a builder-style workflow.
  • The renderer supports static shapes such as circle, cube, globular, square, random, star, and star2.
  • Performance tools include distance-based particle reduction, line-of-sight culling, TPS-aware density scaling, and viewer-side toggles.
  • Maintenance tools such as /me doctor and /me doctor fix help detect and repair malformed Moreeffect data.
  • The plugin supports storage fallback and database use through SQLite or MySQL, plus placeholder support inside its own codebase.

COMMANDS:

Member Command

  • /me help -> Show the member help menu.
  • /me item flag hide -> Hide or show the red Moreeffect lore on the selected item.
  • /me item hand main|off -> Choose which hand item commands will use.
  • /me preview <effect> <type> <size> <height> [amount] -> Preview a custom effect on yourself before applying it.
  • /me preview <preset> -> Preview a saved or built-in preset on yourself.
  • /me preview stop -> Stop the current preview session.
  • /me on -> Enable your own public effects so other players can see them.
  • /me off -> Disable your own public effects so other players cannot see them.
  • /me effect on -> Show other players' effects on your client again.
  • /me effect off -> Hide other players' effects on your client to reduce visual clutter or lag.

Admin Command

  • /me help -> Show the admin help menu.
  • /me reload -> Reload config, presets, language files, and plugin storage state.
  • /me lang vn|en -> Change the global plugin language.
  • /me dashboard -> Open the Moreeffect dashboard GUI.
  • /me gui -> Open the Moreeffect dashboard GUI.
  • /me save <name> [theme] -> Save the current source as a preset.
  • /me save item <name> [theme] -> Save the selected item's effects as a preset.
  • /me save player <player> <name> [theme] -> Save a player's effects as a preset.
  • /me load <preset> -> Load a preset into the current source.
  • /me load item <preset> -> Load a preset into the selected item.
  • /me load player <player> <preset> -> Load a preset into a target player.
  • /me export text <preset> -> Export a preset as shareable text code.
  • /me export yml <preset> -> Export a preset as a YML file.
  • /me import text <name> <code> -> Import a preset from text code.
  • /me import yml <file> [name] -> Import a preset from a YML file.
  • /me clone item -> Clone effects from the selected hand to the other hand.
  • /me clone item <main|off> <main|off> -> Clone effects between main-hand and off-hand items.
  • /me clone player <from> <to> -> Clone effects from one player to another.
  • /me debug -> Show general debug information about the plugin.
  • /me debug status -> Show TPS, performance throttling, and density status.
  • /me debug color -> List particles that support color data.
  • /me debug special -> List particles that need special or custom data.
  • /me debug <particle> -> Inspect one specific particle in detail.
  • /me doctor -> Scan config, presets, profiles, and held items for malformed data.
  • /me doctor fix -> Scan and automatically repair malformed Moreeffect data.
  • /me item add <effect> <type> <size> <height> <id> [amount] -> Add an effect to the selected item.
  • /me item clear <effect> <id> -> Remove an effect from the selected item by particle and ID.
  • /me item set <id> <effect> <type> <size> <height> [amount] -> Replace an existing selected-item effect.
  • /me player add <effect> <type> <size> <height> <id> [amount] -> Add an effect directly to a player.
  • /me player clear <effect> <id> -> Remove a player effect by particle and ID.
  • /me player set <player> <id> <effect> <type> <size> <height> [amount] -> Replace an existing player effect.

PERMISSION:

  • moreeffect.admin -> Full administrative access to Moreeffect commands.
  • moreeffect.use -> Base permission for member-level Moreeffect features.
  • moreeffect.command.item -> Allow /me item add, /me item clear, and /me item set.
  • moreeffect.command.item.flag -> Allow /me item flag hide.
  • moreeffect.command.item.hand -> Allow /me item hand main|off.
  • moreeffect.command.player -> Allow /me player add, /me player clear, and /me player set.
  • moreeffect.command.dashboard -> Allow opening the dashboard or GUI.
  • moreeffect.command.reload -> Allow /me reload.
  • moreeffect.command.lang -> Allow /me lang vn|en.
  • moreeffect.command.save -> Allow saving presets with /me save.
  • moreeffect.command.load -> Allow loading presets with /me load.
  • moreeffect.command.export -> Allow exporting presets with /me export.
  • moreeffect.command.import -> Allow importing presets with /me import.
  • moreeffect.command.clone -> Allow cloning effects between items or players.
  • moreeffect.command.debug -> Allow using the debug command set.
  • moreeffect.command.doctor -> Allow using the doctor scan and repair tools.
  • moreeffect.command.preview -> Allow using effect preview commands.
  • moreeffect.command.toggle.self -> Allow /me on and /me off.
  • moreeffect.command.toggle.view -> Allow /me effect on and /me effect off.
  • moreeffect.bypass.cooldown -> Bypass effect-edit cooldown restrictions.

PLACEHOLDER:

  • %moreeffect_language% -> Current plugin language key.
  • %moreeffect_player% -> Current player name.
  • %moreeffect_player_effect_count% -> Number of effects attached directly to the player.
  • %moreeffect_item_effect_count% -> Number of effects on the currently selected item hand.
  • %moreeffect_selected_hand_effect_count% -> Number of effects on the currently selected hand.
  • %moreeffect_mainhand_effect_count% -> Number of effects on the main-hand item.
  • %moreeffect_offhand_effect_count% -> Number of effects on the off-hand item.
  • %moreeffect_equipped_item_effect_count% -> Total number of effects on both equipped hand items.
  • %moreeffect_total_effect_count% -> Combined total of player effects and equipped hand-item effects.
  • %moreeffect_self_effect_state% -> Whether the player's own effects are on or off.
  • %moreeffect_view_other_effect_state% -> Whether other players' effects are visible to the viewer.
  • %moreeffect_has_item% -> Whether the selected hand currently holds a usable item.
  • %moreeffect_selected_hand% -> Current selected hand key: main or off.
  • %moreeffect_player_effects% -> Comma-separated list of player effect names.
  • %moreeffect_item_effects% -> Comma-separated list of selected-item effect names.
  • %moreeffect_preview_effect_count% -> Number of effects currently being previewed.
  • %moreeffect_preset_count% -> Total number of presets currently loaded.

IMPORTANT NOTE:

  • Moreeffect is mainly a cosmetic particle system. It does not add combat stats, damage boosts, or anti-cheat features by itself.
  • <effect> should be a valid Minecraft particle name supported by the server version.
  • <size> must stay within the plugin limit and is intended to remain under 20 blocks.
  • <height> accepts both named anchors such as center, head, leg, top, bottom and direct numeric values.
  • Item effects only appear while the infused item is being held in the selected hand.
  • Player effects remain visible until removed, unless a viewer disables them locally with /me effect off.
  • Some particles in Minecraft have their own native visual behavior, so even a static Moreeffect shape may still look animated depending on the particle itself.
  • The dashboard, preset, import/export, debug, and doctor systems should be tested by staff before production use on a live server.