Saltar al contenido principal

EliteMobs 10 Documentation Audit — Final Report

Date: 2026-02-14 Scope: 56 wiki pages vs 1,367 Java source classes (EliteMobs v10.0.0-SNAPSHOT) Agents: 6 parallel auditors covering core systems, combat, items/bosses, EliteScript, quests/NPCs/dungeons, and undocumented features

Executive Summary​

CategoryCount
CRITICAL issues (wrong/misleading info)3
HIGH priority gaps (major undocumented features)5
MEDIUM priority gaps (incomplete sections)14
LOW priority gaps (minor/cosmetic)12
Wiki pages in good shape~40 of 56

Best documented areas: EliteScript (near-perfect), premade powers (69/69 match), boss config keys (65+/65+ match), enchantments (16/16 match), reinforcements, loot tables.

Worst documented areas: Gambling system (zero docs), skill bonuses (90+ skills undocumented), player damage formula (outdated), config settings (5+ config files missing).

CRITICAL — Wrong or Misleading Information​

C1. Player-to-Elite Damage Formula is Outdated​

File: damage_system.md — "Damage dealt to Custom Bosses" section Wiki says: Single "effectiveLevel" combining skill + item, formula 0.73 * 2^(effectiveLevel / 5) Source says: Two separate adjustment layers:

  • baseDamage = mobHP / 3.0
  • skillAdjustment = 2^((weaponSkillLevel - mobLevel) / 7.5)
  • weaponAdjustment = two-part linear curve (0.5 to 1.25)
  • attackSpeedFactor = 1.6 / actualAttackSpeed Impact: Players/devs using the wiki formula will get completely wrong numbers. Fix: Rewrite the player damage section with the actual v10 formula from WeaponOffenseCalculator.java and DamageBreakdown.java.

C2. SMELTER/ENHANCER/REFINER Listed as Functional in Arenas​

File: creating_arenas.md — Special [4] NPC interaction table Wiki says: SMELTER "Opens the smelt menu", ENHANCER "Opens enhancements menu", REFINER "Opens refiner menu" Source says: These show a "feature replaced" message and removal instructions. Already marked DEPRECATED in creating_npcs.md. Fix: Mark as DEPRECATED in creating_arenas.md to match creating_npcs.md.

C3. ARENA Interaction Type Described Inconsistently​

File: creating_arenas.md says ARENA "Opens the arena menu" File: creating_npcs.md says ARENA "Does nothing. Use ARENA_MASTER instead." Source says: ARENA has no handler — falls through to default: break. Does nothing. Fix: Update creating_arenas.md to say "Does nothing. Use ARENA_MASTER."

HIGH — Major Undocumented Features​

H1. Gambling System — NEW PAGE NEEDED: gambling_system.md​

Source: 11 files across economy/, gambling/, menus/gambling/, config/GamblingConfig.java Content: 4 minigames (Blackjack, Coin Flip, Slots, Higher/Lower), debt system (500 coin max), Debt Collector boss, Gambling Den Owner NPC with house earnings display. 100+ config keys in GamblingSettings.yml. Current coverage: Only mentioned in feature_list.md (1 line) and NPC interaction type tables.

H2. Skill Bonuses — NEW PAGE NEEDED: skill_bonuses.md​

Source: 94 files in skills/bonuses/ with 84 individual skill implementations Content: 9 weapon categories with 6-10 unique skills each (e.g., Swords: Lacerate, Riposte, Vorpal Strike; Axes: Devastating Blow, Executioner; Bows: Multishot, Dead Eye; etc.). 4 unlock tiers at levels 10/25/50/75. Max 3 active per weapon. 5 bonus types (Proc, Passive, Conditional, Stacking, Cooldown). Current coverage: 6 lines in damage_system.md. Zero individual skill documentation.

H3. Five Config Files Missing from Wiki​

Files not in elitemobs_config_settings.md:

  1. GamblingSettings.yml (100+ keys)
  2. skills.yml (XP rates, skill caps, bonuses)
  3. Sounds.yml (treasure chest, quest sounds)
  4. Quests.yml (80+ global quest settings)
  5. Models.yml (custom model settings) Fix: Add sections for each to the config settings page, or split into per-file pages.

H4. Dynamic Quest System Undocumented​

Source: DynamicQuest.java — procedural quests auto-generated from combat level Content: Combat level / 5 = quest level (1-20). 3 quests per tier, auto-refresh every 60s. Quests adapt to dungeon level when entering dynamic dungeons. Current coverage: Zero.

H5. Player Damage Formula Missing: Weapon Adjustment Curve, Sweep, Thorns​

Source: WeaponOffenseCalculator.java, DamageBreakdown.java Content: Two-part linear weapon adjustment (0.5 to 1.25 range), sweep damage (25% for secondary targets), thorns formula (2% base per level), attackSpeedFactor normalizing DPS across weapon types. Current coverage: None of these mechanics are documented.

MEDIUM — Incomplete Sections or Missing Documentation​

M1. Translation System — FAQ is Stale​

faq.md describes old YAML-based system. Source uses CSV-based system with auto-merge, Excel BOM, indexed lists. Needs update or new translations.md.

M2. On-Death Commands — Undocumented​

OnDeathCommands.java — console commands on elite death with placeholders ($damager1-3name, $players, $level, $name, $location*) and chance syntax ($chance=0.5$). Not documented.

M3. Custom Music System — Undocumented​

CustomMusic.java — boss/dungeon music with intro->loop transitions. Format: name=sound length=ms->name=loop length=ms. Not documented as standalone feature.

M4. Player Status Screen — Undocumented​

9 pages (Cover, Stats, Gear, Teleports, Commands, Quests, Boss Tracking, Skills). Three display modes (Book, Chest, Dialog). Not documented.

M5. Arrow Shop — Minimal Coverage​

7 arrow types (Regular, Spectral, 5 Tipped). Configurable prices. Only mentioned as NPC interaction type.

M6. Developer API — Zero Documentation​

50+ custom Bukkit events across combat, dungeons, arenas, quests, NPCs, instanced content. Zero wiki coverage.

M7. MythicMobs Integration — Undocumented​

Functional integration for spawning MythicMobs entities. Only a passing mention in arena docs.

M8. Placeholders Not Documented Across All Text Actions (EliteScript)​

parsePlaceholders() supports $playerName, $bossName, etc. in MESSAGE, TITLE_MESSAGE, ACTION_BAR_MESSAGE, BOSS_BAR_MESSAGE — but wiki only documents them for RUN_COMMAND_AS_PLAYER.

M9. moveToTarget Particle Attribute (EliteScript)​

ScriptParticlesBlueprint.java has moveToTarget Boolean field. Not in wiki's SPAWN_PARTICLE docs.

M10. Dungeon Packager Missing Keys​

worldGuardFlags, relativeBossLocations, relativeTreasureChestLocations, nightbreakSlug not documented.

M11. Obsolete Loot Examples in creating_bosses.md​

SCRAP:level=5-10:... and UPGRADE_ITEM:level=5-10:... examples — these keywords don't exist in current source.

M12. Procedural Item Tiers Undocumented​

5 tiers (Bronze Lv20, Palladium Lv40, Corrupted Lv60, Living Lv80, Ultimatium Lv100) with resource pack model IDs. Zero documentation.

M13. Special Item Systems — Challenge Arenas​

SpecialItemSystemsConfig.java — enchantment failure can trigger challenge boss fights. 30% chance on failure, 10% critical fail during challenge. May not be fully documented.

M14. Gear Restriction Level-20 Free Zone​

GearRestrictionHandler.java:47 — items level 20 or below bypass skill restrictions. Not documented.

LOW — Minor Gaps​

L1. Soft-Dependencies Not Listed in Setup​

Geyser-Spigot, MythicMobs, LevelledMobs, InfernalMobs, HolographicDisplays, Multiverse-Core not mentioned in setup.md.

L2. Permission Node Mismatches (Source vs plugin.yml)​

elitemobs.package vs elitemobs.dungeon.package, elitemobs.place.npc vs elitemobs.place.admin, elitemobs.shop.command vs elitemobs.shop.custom. Several permissions in source but not in plugin.yml.

L3. Missing Debug Combat Commands​

/em debug combat results and /em debug combat test <type> not in wiki.

L4. Spear Minecraft Version Mismatch​

Wiki says 1.21.5+, source says 1.21.11+.

L5. Modifier Clamping (0.125x-8.0x) Not Documented​

LevelScaling.java clamps damage modifier at ±15 levels. Not in wiki.

L6. XP-to-Next-Level Formula Not Documented​

20 * L^3 for levels 1-100, soft cap multiplier 1 + ((L-100)^2/100) for 100+. Only the mob XP formula is documented.

L7. DamageBreakdown Debug Tool Not Documented​

Full per-player damage breakdown tracking for testing. Useful for dungeon designers.

L8. Aggro System References "EliteMobs 7.2"​

advanced_aggro_system.md opening line is outdated. Should confirm EM10 compatibility.

L9. teleportLocation Missing from Arena Config Section​

Only in Arena NPC section, not in main arena config.

L10. Orphaned Heading in creating_world_bosses.md​

### Transitive Blocks at line 244 with no content before ### isPersistent at line 246.

L11. Feature List "Guild Progression" Reference​

Line 22 says treasure chests "locked based on guild progression" — may need updating to "skill level."

L12. Combat Tag Config Not Documented​

CombatTag.yml settings (fly prevention, teleport timer) not in config settings page.

PriorityFilenameContent
HIGHgambling_system.md4 games, debt system, Debt Collector boss, all config, NPC setup
HIGHskill_bonuses.mdAll 84+ skills by weapon type, unlock tiers, selection mechanics, config
MEDIUMdeveloper_api.md50+ custom events with descriptions, fields, usage examples
MEDIUMtranslations.mdCSV system, custom translations, file format, "custom" mode
LOWplayer_status_screen.mdAll 9 pages, access method, display modes, config
FileReason
damage_system.mdPlayer damage formula is wrong. Weapon adjustment curve, sweep, thorns all missing.
elitemobs_config_settings.mdMissing 5+ entire config files. Needs major expansion.
creating_arenas.mdDeprecated NPC types listed as active. ARENA interaction type wrong.
FileFix
creating_bosses.mdRemove obsolete SCRAP/UPGRADE_ITEM loot examples
creating_world_bosses.mdFix orphaned Transitive Blocks heading
elitescript_actions.mdAdd placeholder note to MESSAGE/TITLE/ACTION_BAR/BOSS_BAR sections; add moveToTarget to particles
setup.mdAdd new soft-dependencies (Geyser, MythicMobs, etc.)
permissions_and_commands.mdAdd missing debug combat commands; fix /em package syntax
guild_tier_loot_limiter.mdAdd gear restriction level-20 free zone; XP formula
advanced_aggro_system.mdUpdate opening line from "EliteMobs 7.2" to confirm EM10
feature_list.mdAdd Dynamic Dungeons; fix "guild progression" wording
faq.mdUpdate translation section for CSV system
damage_system.mdAdd modifier clamping, XP-to-next-level formula
spawning_tiers_loot.mdClarify XP capping mechanism for overleveled mobs

Prioritized Implementation Backlog​

Phase A — Fix Wrong Information (do first):

  1. Rewrite player damage formula in damage_system.md
  2. Fix deprecated NPC types in creating_arenas.md
  3. Remove obsolete loot examples from creating_bosses.md

Phase B — Document Major Missing Systems: 4. Create gambling_system.md 5. Create skill_bonuses.md 6. Add missing config files to elitemobs_config_settings.md 7. Document dynamic quest system

Phase C — Fill Medium Gaps: 8. Update translation docs (FAQ + new page) 9. Document on-death commands 10. Document custom music system 11. Document player status screen 12. Document arrow shop 13. Add EliteScript placeholder notes 14. Document procedural item tiers 15. Document gear restriction level-20 free zone

Phase D — Polish: 16. Create developer API page 17. Fix all LOW priority items (permissions, versions, headings, etc.) 18. Add MythicMobs integration docs 19. Document DamageBreakdown debug tool