ModsJava
MyItemsCompat 1.21.X+ | RPG, Stats, Skills, Gems, Sets, Blocks, Gift Packs
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.Click to expand...
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
Code (Text):
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
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)Click to expand...
- /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
Spoiler: 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
Spoiler: 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
Spoiler: Custom Blocks /mic block
- list — List all custom blocks
- give <player> <block_id> [amount] — Give custom block
Spoiler: 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.
Code (Text):
┌─ 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
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)
Code (Text):
@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
Passive Buffs (Buff)
Code (Text):
@MyItems, Buff = SPEED, Grade = 2
@MyItems, Buff = NIGHT_VISION, Grade = 1
Code (Text):
@MyItems, Ability = LIGHTNING, Grade = 3, Chance = 25.0
@MyItems, Ability = VAMPIRISM, Grade = 2, Chance = 15.0
Code (Text):
@MyItems, Power = SPECIAL, Click = RIGHT, Type = BLINK, Cooldown = 5.0
@MyItems, Power = SPECIAL, Click = SHIFT_RIGHT, Type = FISSURE, Cooldown = 10.0
Command Skills (PowerCommand)
Code (Text):
@MyItems, PowerCommand = "effect <player> speed 60 2", Click = RIGHT, Cooldown = 30
Projectile Skills (PowerShoot)
Code (Text):
@MyItems, PowerShoot = ARROW, Click = RIGHT, Damage = 8.0, Cooldown = 5
@MyItems, PowerShoot = WITHER_SKULL, Click = SHIFT_RIGHT, Damage = 15.0, Cooldown = 15
Elements (Element)
Code (Text):
@MyItems, Element = FireI, Value = 30.0
Code (Text):
@MyItems, Socket = EDFS2
Combat System
Damage Formula
Code (Text):
Base Damage = ATK × Damage Scale Factor
Damage Reduction = DEF × Defense Scale Factor
Final Damage = (Base Damage - Damage Reduction) × Random Variance × Crit Multiplier
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)
- ATK → Main Hand, Off Hand
- DEF → Helmet, Chestplate, Leggings, Boots
- HP → All armor slots + Main Hand + Off Hand
- Crit Chance / Crit Damage → Main Hand, Off Hand
- Hit Rate → Main Hand, Off Hand
- Block Rate / Dodge Rate → Helmet, Chestplate, Leggings, Boots
- PvE / PvP Damage → Main Hand, Off Hand
All slot rules freely adjustable in config.yml under the stats-slots section.
[HR]
Customization Tutorial
Create New Skill
Edit ability_weapon.yml:
Code (Text):
MY_CUSTOM_ABILITY:
max-grade: 10
base-duration: 100
scale-duration: 20
base-bonus-damage: 5.0
scale-percent-damage: 2.0
Edit element.yml:
Code (Text):
CustomElement:
keylore: "Custom Element"
damage-bonus: 5.0
scale-percent: 2.0
potion-effects:
- type: SLOW
duration: 60
amplifier: 1
counters:
FireI: 1.5
Edit messages.yml, add under languages::
Code (Text):
ja:
prefix: "&6[MyItemsCompat]"
general:
reload: "{prefix} &a設定が再読み込みされました。"
# ... translate all message keys
[HR]
Web Editor (Beta)
Built-in HTTP server, visual item builder in browser, no need to hand-write YAML.Click to expand...
- Ensure editor.port in config.yml is available
- Run /mic editor in-game to create a session
- Click the chat link to open browser
- Session valid for 20 minutes, /mic editor verify <code> to renew
Features:
- Visual builder for all @Myitems tags
- Material browser + Item ID browser
- Visual gem socketing editor
- Real-time YAML preview + export save
- Bilingual UI (Chinese/English), responsive layout
[HR]
FAQ
- Q: Can I use legacy MyItems items directly?
A: Yes. Auto-imports from MyItems/Database/item.yml.
- Q: How to change skill display names?
A: Edit identifier-xxx under ability: in config.yml.
- Q: How to disable a sound effect?
A: Set it to "" in sounds.yml.
- Q: What projectile types are supported?
A: ARROW SNOWBALL EGG FIREBALL SMALL_FIREBALL WITHER_SKULL
- Q: PowerCommand placeholders?
A: <player> <world> <x> <y> <z>
- Q: How to hot-reload configs?
A: /mic reload
- Q: Compatible with LuckPerms?
A: Fully compatible, uses standard Bukkit permission API.
- Q: Can it run without dependencies?
A: Yes, runs standalone with zero dependencies.
[HR]
Version History
- 2.0.0 — Full rewrite: Web editor, socket gem system, custom blocks, gift pack system, resource pack generator, internationalization, three-tier permission system
[HR]
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.21, 26.1, 26.2
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
MyItemsCompat 1.21.X+ | RPG, Stats, Skills, Gems, Sets, Blocks, Gift Packs is a free Minecraft Java mod. Compatible with Minecraft 1.21, 26.1, 26.2. Downloaded 95 times (via Spigot). Download it and open it directly in the game.