ThicMobKai - Dungeon, Boss and Mob RPG System

OVERVIEW
ThicMobKai is a premium RPG plugin built for servers that want a clean, polished, and highly configurable progression system.
It combines:
- custom farm mobs
- dungeon mobs
- hidden bosses
- world bosses
- boss chests
- loot progression
- collection tracking
- bestiary tracking
- titles
- dungeon cards
- auto spawners
- GUI-based admin tools
This plugin is made for servers that want more than just a mob plugin.
It is designed to feel like a full progression framework.
[HR][/HR]
MAIN FEATURES
CUSTOM MOBS
- Farm mobs and dungeon mobs are separated for cleaner balancing.
- Each mob can scale by level.
- Each mob can have custom drops, skills, model IDs, and region-based behavior.
- Easy to edit through YAML.
DUNGEON SYSTEM
- Dungeon hub with cards, attempts, rankings, and progression flow.
- Dungeon runs can include waves, boss stages, and random mutations.
- Dungeon cards unlock content in a clean progression path.
- Boss cards, reward cards, and loot cards can all be configured.
BOSS SYSTEM
- Dungeon bosses with top damage tracking.
- World bosses with separate announcements and reward chests.
- Hidden / elite bosses triggered by kill milestones or combo milestones.
- Boss kills can reward Top 1-5 players with separate loot chests.
PROGRESSION SYSTEM
- Mob Bestiary
- Collection Book
- Lucky Top
- Drop History
- Titles
- Player Profile
- Built-in plugin level system
- Skill tree upgrades for damage, speed, health, and luck
ADMIN TOOLS
- GUI-based editing for mobs, drops, bosses, cards, and spawners
- Wand-based region setup
- Auto spawner placement
- Easy setup flow for server owners
- Configurable language files
- Separate YAML files for each major system
INTEGRATIONS
- ModelEngine 4 support
- PlaceholderAPI support
- DiscordSRV hooks
- EN / VI language support
- Custom model data support for items
[HR][/HR]
WHY THICMOBKAI?
If you want a plugin that feels premium, organized, and flexible, ThicMobKai is made for that.
It is built around:
- clean GUI design
- balanced progression
- configurable lore
- bilingual support
- separated data files
- server-friendly setup
- premium RPG feeling
This is not meant to be a simple mob spawner plugin.
It is meant to be the core of a custom dungeon and mob progression system.
[HR][/HR]
FEATURE HIGHLIGHTS
• Custom farm mobs with region themes
• Dungeon mobs with stronger scaling and drop tables
• Dungeon cards for unlock and reward flow
• Hidden bosses and elite boss mechanics
• World boss rewards with Top 1-5 chest drops
• Bestiary progress for farm mobs
• Collection Book for dungeon item sets
• Lucky Top for rare item value tracking
• Titles shown in chat and tab list
• Player Profile with separate plugin level
• GUI admin setup for fast balancing
• EN / VI language switching without rebuilding
• ModelEngine 4 and DiscordSRV support
[HR][/HR]
CONFIG FILES
Main files:

• config.yml
• lang/en.yml
• lang/vi.yml
• farm-mobs.yml
• dungeon-mobs.yml
• bosses.yml
• world-bosses.yml
• world-boss-chests.yml
• hidden-bosses.yml
• dungeons.yml
• spawners.yml
• skills.yml
• collections.yml
• titles.yml
• card-rewards.yml
• secret-treasures.yml
• stats.yml

What can be edited:
- GUI titles
- lore
- command help text
- mob names
- dungeon names
- boss names
- reward text
- language text
- spawner settings
- boss loot pools
- card reward pools
[HR][/HR]
INSTALLATION
1. Place the plugin jar into your plugins folder.
2. Start the server once to generate all files.
3. Edit `config.yml` and choose your language:
- `en` = English
- `vi` = Vietnamese
4. Edit the generated YAML files to fit your server.
5. Restart the server or use `/tmk reload`.
[HR][/HR]
COMMANDS
Main command: `/tmk`
Useful commands:

• /tmk help
• /tmk gui
• /tmk dungeon
• /tmk dungeon top
• /tmk dungeon buy <id> [amount] [money|playerpoints|xucorekai]
• /tmk dungeon leave
• /tmk boss
• /tmk admin
• /tmk bossadmin
• /tmk cardadmin
• /tmk top
• /tmk lucky
• /tmk collection
• /tmk bestiary
• /tmk history
• /tmk title
• /tmk skill
• /tmk level
• /tmk cap
• /tmk itemtop <item-id>
• /tmk spawn <mob> [amount] [level] [dungeon]
• /tmk kill <mob|all>
• /tmk card <rank> [amount] [player]
• /tmk setdungeon <id> <rank>
• /tmk spawner create <name> <mob> [level] [dungeon] [radius] [interval] [maxAlive]
• /tmk spawner item <name> <mob> [level] [dungeon]
• /tmk spawner delete <name>
• /tmk wand <name> <mob> [level] [dungeon] [amount] [radius] [interval] [maxAlive]
• /tmk reload

Aliases:
- `/thicmob`
- `/tml`
[HR][/HR]
PERMISSIONS

• `thicmobkai.admin` - full admin access
• `thicmobkai.top` - view ranking GUIs

[HR][/HR]
SUPPORTED INTEGRATIONS
ModelEngine 4
Use `model4-id` in your mob files and configure the apply command in `config.yml`.
DiscordSRV
Separate channel hooks can be used for:
- mob notifications
- boss notifications
- world boss notifications
- rare drop broadcasts
PlaceholderAPI
You can use placeholders for chat, tab, scoreboard, and other systems.
[HR][/HR]
SCREENSHOTS

[HR][/HR]
FINAL NOTES
- Save YAML files as UTF-8 to preserve Vietnamese characters.
- Most GUI titles and lore can be customized from the language files.
- The plugin is built to feel premium and configurable.
- Use `/tmk reload` after editing files.
- Test changes on a backup server first before putting them live.