MyItemsCompat 1.21.X+ | RPG, Stats, Skills, Gems, Sets, Bloc

MyItemsCompat

[RPG] [Stats] [Skills] [Gems] [Sets] [Blocks] — 1.21.X+ Highly Customizable RPG Item Engine

10 Stats · 30+ Skills · 15+ Buffs · Custom Elements · Socket Gems · Set Effects · Custom Blocks · All YAML Configurable

Documentation & Tutorials → wiki.freescdn.com/MyItemsCompat

[HR]

Why MyItemsCompat?

One line of @MyItems — turn anything into RPG gear.

MyItemsCompat is a full-featured RPG item engine built for Paper servers. It fully inherits the classic MyItems 1.12 and below item data system, with comprehensive expansion and restructuring for modern servers.

Simply write a single @Myitems tag in item lore to define a piece of equipment with complete RPG attributes — from basic ATK/DEF, crit/dodge, to passive buffs, triggered skills, elemental combat, socket gems, set effects. All parameters are fully configurable via YAML, no coding required.

What Can It Do?

• 10 Base Stats — ATK, DEF, HP, Crit Chance, Crit Damage, Hit Rate, Block Rate, Dodge Rate, PvE/PvP Damage Bonus, each stat independently configurable for which slots it applies to
• 30+ Trigger Skills — Poison, Lightning, Lifesteal, Frostbind, Entangle, Amaterasu, Nero Beam... triggered on hit, chance/grade/cooldown fully configurable
• Active Skill System — Right-click to cast Blink, Fissure, Ice Spike, plus command skills and projectile skills (arrows/fireballs/wither skulls)
• 15+ Passive Buffs — Speed, Strength, Night Vision, Fire Resistance, Regeneration... equip to activate, level-scalable
• Custom Elements — Fire/Water/Wind/Earth or any custom element, counter relationships, damage bonuses, attached potion effects fully configurable
• Socket Gems — Weapon/Armor/Universal gem categories, multi-tier, success rate mechanic, visual GUI socketing
• Set Effects — Define set combinations, one-click give full set, auto-load from legacy configs
• Custom Blocks — Custom hardness, mining speed multiplier, place/break event handling
• Choice Gift Packs — GUI paginated browsing, player picks one reward, supports gems and items
• Item Binding — Bind held item, display owner, level restrictions
• Random Generator — Generate random gear by series name, perfect for lootboxes/drops
• Full Damage Engine — Overrides vanilla calculation, crit/dodge/block/hit detection, Action Bar real-time damage display
• Web Editor — Visual item builder in browser, real-time YAML preview, bilingual UI
• Zero Dependencies — Runs standalone, optional MythicMobs drop table integration

How Customizable Is It?

• Legacy Compatible → Zero-modification migration of old MyItems lore tags, auto-detects @Myitems format
• Ultimate Freedom → 10 Stats × 30+ Skills × 15+ Buffs × Custom Elements × Socket Gems × Set Effects, combine freely
• Full-Chain Config → From item stats, damage formulas, slot rules to sound effects and particles, all YAML configurable, no code changes
• Visual Editing → Built-in web editor, drag-and-drop item building in browser, real-time YAML preview
• Out of the Box → Zero dependencies, runs standalone; optional MythicMobs drop table integration
• Modern Architecture → PDC persistence, cached parsing, async update checker, deeply optimized for Paper 26.1.2+

[HR]

Supported Environment

• Server Core → Paper 26.1.2+ (recommended) / Spigot 1.21+
• Compatible Cores → Paper · Purpur · Folia and other Paper API-based cores
• Java Version → Java 21+
• Dependencies → None (runs standalone)
• Soft Dependency → MythicMobs (optional, native drop integration)

[HR]

Quick Start

1. Place MyItemsCompat.jar in the plugins/ directory
2. Start the server → config files auto-generated
3. If you have legacy MyItems data → auto-reads MyItems/Database/item.yml and imports
4. Run /mic help to get started

[HR]

Feature Matrix

Core Engine

• Lore Parser Engine — Parses @Myitems tags, PDC persistence, built-in cache | Supports all legacy tag formats
• Stats System — 10 configurable stats, custom slot rules | Each stat independently configurable for active slots
• Damage Engine — Full vanilla calculation override, ATK/DEF/crit/dodge/block/hit | All formula parameters configurable
• Buff System — 15+ passive effects, level scaling, anti-flicker | Period/duration/level multiplier configurable
• Skill System — 30+ trigger skills + active skills + command skills + projectiles | Chance/grade/cooldown/click type fully configurable
• Element System — Custom elements (Fire/Water/Wind/Earth...), counter relationships | Element name/damage bonus/counter ratio fully configurable
• Variable Parser — Dynamic variable replacement in lore and names | Configurable real-time parsing
• Sound System — Independent sound per action | Sound/volume/pitch fully configurable, can mute

Gameplay Extensions

• Socket Gems — Categorized gems (weapon/armor/universal), multi-tier, success rate mechanic | GUI interface, gem consumed on fail, effects auto-counted in stats
• Slot Management — Global/per-item slot limits, consumable opener | Opener appearance/material/name/lore fully configurable
• Item Binding — Bind on hold, display owner, level restrictions | Configurable rebinding strategy
• Set System — Define set combinations, one-click give | Auto-load from legacy configs
• Random Generator — Random item generation by series name | Multiple series configurable
• Choice Gift Pack — GUI paginated browsing, player picks one reward | Supports gems and items
• Custom Blocks — Custom hardness/mining speed, place/break events | Block properties fully configurable
• Consumables — Custom food/potion effects | Event-driven

Management Tools

• Item Import — Batch YML import, category filtering, auto-overwrite | Stable
• Web Editor — Visual editing in browser, real-time YAML preview, bilingual UI | Beta
• Texture Manager — CustomModelData mapping, legacy damage migration | In Development
• Resource Pack Generator — One-click generate 1.21~26.2 format resource pack zip | Planned
• Debug System — Player monitoring, type filtering, full metadata viewing | Stable
• Internationalization — Chinese/English bilingual, extensible to any language | Stable
• MythicMobs — Native drop registration myitems{id=item_name} | Stable
• Update Checker — Async check, admin notification, can be disabled | Stable

[HR]

Command Reference

Main command: /myitemscompat Alias: /mic
Players without permission won't see any command hints (silent reject)

Player Commands

• /mic help [page] — Paginated help, clickable fill-in → myitemscompat.help
• /mic hp — View health details → myitemscompat.hp
• /mic bind — Bind held item → myitemscompat.bind
• /mic stats <player> — View all player stats → myitemscompat.stats
• /mic info — Plugin info and system status → myitemscompat.info

Admin Commands

• /mic reload — Reload all configs + refresh stats → myitemscompat.reload
• /mic import <file> [type] [overwrite] — Import YML item file → myitemscompat.import
• /mic list — List importable files → myitemscompat.list
• /mic give <player> <item> [amount] — Give item (fuzzy search supported) → myitemscompat.give
• /mic save <item_name> — Save held item to database → myitemscompat.save
• /mic detail — View held item full metadata → myitemscompat.detail
• /mic gem <gem_name> [level] [player] — Give gem → myitemscompat.gem
• /mic generator <series> [player] — Random item generation → myitemscompat.generator
• /mic set <set_name> [player] — Give full set → myitemscompat.set
• /mic opener <player> [amount] — Give socket opener → myitemscompat.opener
• /mic fix <pdc|all> — Fix item data → myitemscompat.fix
• /mic config — View current config data → myitemscompat.config
• /mic editor [verify|status] — Web editor → myitemscompat.editor
• /mic debug [subcommand] — Debug system → myitemscompat.debug

Sub-Command Groups

Texture Management /mic texture

• info <item_id> — View item texture details
• list — List all configured textured items
• generate [directory] — Generate OptiFine CIT files
• pack [filename] — Generate modern resource pack zip
• status — View texture system status

Socket Management /mic socket

• set <max_slots> — Set held item max socket slots
• add <amount> — Add empty socket slots
• info — View held item slot info

Custom Blocks /mic block

• list — List all custom blocks
• give <player> <block_id> [amount] — Give custom block

Debug System /mic debug

• status — Debug status
• toggle / on / off — Toggle debug mode
• watch <player> — Monitor specified player
• type <type> — Filter log type
• clear-players — Clear monitored players
• clear-types — Clear monitored types
• player <player> — View held item full details
• all — All imported data overview
• gems — Gem details
• generators — Random generators
• sets — Set list

[HR]

Permission System

Three-tier permission design, fully compatible with LuckPerms and other permission plugins.

┌─ myitemscompat.user ──── default: true ──── All players auto-have
│   ├── bind       Bind items
│   ├── stats      View stats
│   ├── help       View help
│   └── hp         View health
│
├─ myitemscompat.admin ─── default: op ────── Full admin permissions
│   ├── Inherits all user sub-permissions
│   ├── reload      Reload configs     ├── import      Import items
│   ├── list        List files         ├── give        Give items
│   ├── opener      Give opener        ├── save        Save items
│   ├── detail      View details       ├── fix         Fix data
│   ├── gem         Give gems          ├── generator   Random generate
│   ├── set         Give sets          ├── texture     Texture manager
│   ├── socket      Slot management    ├── config      View config
│   ├── editor      Web editor         ├── info        Plugin info
│   └── block       Custom blocks
│
├─ myitemscompat.debug ─── default: false ──── Manual assignment required
│   └── Debug commands
│
└─ myitemscompat.* ─────── default: op ────── Same as admin

[HR]

Configuration Files

• config.yml — Main Config — Language, debug, damage formula, buff params, skill range, element toggle, crit, slot rules, binding strategy, socket params, import paths, variables, identifier text, format
• messages.yml — Messages — Chinese/English bilingual, all prompts/help/combat messages, extensible to any language
• web-editor-lang.yml — Editor UI — Web editor interface translations
• textures.yml — Textures — Item → CustomModelData mapping
• socket-gui.yml — Socket GUI — Interface layout/slot configuration
• ability_weapon.yml — Passive Skills — Each skill's max grade/duration/damage bonus
• power_special.yml — Active Skills — Each active skill's duration/damage bonus
• element.yml — Elements — Element definition/damage bonus/counter relations/potion effects
• imports/ — Item Database — YML item file storage directory
• web-tool/ — Editor Frontend — Web editor static resources

[HR]

Item Tag Format

All attributes defined via @Myitems tags in lore. Players see translated readable text, tags hidden in hidden lines.

Stats (LoreStats)

@MyItems, LoreStats = DAMAGE, Value = 25.0
@MyItems, LoreStats = DEFENSE, Value = 15.0
@MyItems, LoreStats = HEALTH, Value = 100.0
@MyItems, LoreStats = CRITICAL_CHANCE, MinValue = 10.0, MaxValue = 15.0

Supported stats: DAMAGE DEFENSE HEALTH CRITICAL_CHANCE CRITICAL_DAMAGE HIT_RATE BLOCK_RATE DODGE_RATE PVE_DAMAGE PVP_DAMAGE

Passive Buffs (Buff)

@MyItems, Buff = SPEED, Grade = 2
@MyItems, Buff = NIGHT_VISION, Grade = 1

On-Hit Skills (Ability)

@MyItems, Ability = LIGHTNING, Grade = 3, Chance = 25.0
@MyItems, Ability = VAMPIRISM, Grade = 2, Chance = 15.0

Active Skills (Power)

@MyItems, Power = SPECIAL, Click = RIGHT, Type = BLINK, Cooldown = 5.0
@MyItems, Power = SPECIAL, Click = SHIFT_RIGHT, Type = FISSURE, Cooldown = 10.0

Click types: RIGHT LEFT SHIFT_RIGHT SHIFT_LEFT

Command Skills (PowerCommand)

@MyItems, PowerCommand = "effect <player> speed 60 2", Click = RIGHT, Cooldown = 30

Placeholders: <player> <world> <x> <y> <z>

Projectile Skills (PowerShoot)

@MyItems, PowerShoot = ARROW, Click = RIGHT, Damage = 8.0, Cooldown = 5
@MyItems, PowerShoot = WITHER_SKULL, Click = SHIFT_RIGHT, Damage = 15.0, Cooldown = 15

Types: ARROW SNOWBALL EGG FIREBALL SMALL_FIREBALL WITHER_SKULL

Elements (Element)

@MyItems, Element = FireI, Value = 30.0

Socket Slots (Socket)

@MyItems, Socket = EDFS2

[HR]

Combat System

Damage Formula

Base Damage = ATK × Damage Scale Factor
Damage Reduction = DEF × Defense Scale Factor
Final Damage = (Base Damage - Damage Reduction) × Random Variance × Crit Multiplier

All coefficients configurable in config.yml.

Combat Events

• Critical Hit — Based on crit chance → Damage × crit multiplier
• Dodge — Based on dodge rate → Completely avoid damage
• Block — Based on block rate → Reduce damage by percentage
• Hit — Based on hit rate → Miss means attack fails

Feedback

• Action Bar real-time damage numbers (crit/dodge/miss effect differentiation)
• Particle effects (configurable)
• Kill notification messages
• All sounds customizable or muteable

[HR]

Stat Slot Rules (Default)