NC Dungeon — Instanced Party Dungeons (includes NC Party)

Take your players into private dungeons with mobs, bosses, chests and loot, alone or in a group of up to 5. Talk to the NPC, join the queue or bring your party, enter your own private copy of the crypt, clear the rooms, defeat the boss and come back with the rewards. Everything is server-authoritative: players only send requests, with anti-spam limits.

NC Party is included in the pack: parties, friends, party finder, chat, mate boxes and loot split.

Highlights

• Private instances: every group gets its own copy of the dungeon (routing buckets). Groups never see each other, everything is cleaned up at the end.
• Ready-to-play crypt: custom MLO floating above Los Santos, with navmesh, 13 mobs in 5 rooms, a boss with phases, 4 animated chests and music.
• In-game dungeon editor: create and edit dungeons on the real interior with a free camera, without touching files or restarting. Draft → Publish, Undo/Redo, test run, Lua export.
• Queue / matchmaking: solo players and incomplete parties wait for a group while walking around the city. Optional roles (tank, healer, dps).
• Works with Qbox, QBCore, ESX or standalone (auto-detected).
• 9 languages: English, Italian, German, French, Spanish, Portuguese, Chinese, Japanese, Korean.
• 5 UI themes: fantasy, sci-fi, horror, steampunk, dieselpunk.
• No database needed: cooldowns, EXP and rejoin data are stored with resource KVP, editor dungeons in a JSON file.

NC Dungeon features

• Entry NPC with map blip, ox_target / qb-target or key interaction; one NPC can offer several dungeons.
• Dungeon menu: level, players, time limit, cooldown and free instances for each dungeon.
• Party confirmation: nearby members accept or refuse within a time limit.
• Smart mobs: server-side AI with guard spots, line of sight, room aggro, chase, leash, melee and ranged attacks. Damage is calculated by the server. Health bars and level over their heads.
• Boss fights: the boss sleeps until you enter its arena. Big themed boss bar, health-based phases, summoned adds and spells you can dodge (fireball, meteor).
• Animated chests: open once per instance with an animation, then vanish and give the reward. They can require the room to be cleared first.
• Objectives: kill all, kill the boss, open the chests, kill N of a type, reach a point, survive. On-screen tracker with counters and timer.
• Death handling: stay down up to 5 minutes, a mate can revive you, or choose Respawn at the entrance or Leave the dungeon.
• End of run: countdown, return to the NPC, completion reward, account-bound cooldown.
• Rejoin protection: players who disconnect inside a dungeon are safely returned to the NPC.
• Music: looping ambient track and boss music with crossfade; each player sets their own volume.
• Mob sounds with distance and stereo positioning.
• Rewards and EXP: loot tables for chests, boss and completion (items and money). EXP goes to NC Rift, your framework, KVP or your own functions.
• Admin tools: list and close instances, solo test run, save points, clear cooldowns, debug log on demand.
• Developer API: exports (IsInDungeon, GetInstanceOf, GetInstance, StartDungeon, EndInstance) and server events (onStart, onObjective, onMobKilled, onEnd).

NC Party features (included)

• Parties up to 5 players (configurable): invite by ID or nearest player, kick, pass the lead.
• /party panel with Party, Find, Friends and Chat tabs (also on a rebindable key).
• Party finder: "looking for members" / "looking for a party" with notes and join requests.
• Friends list with online status and join notices.
• Party chat and private messages.
• Mate boxes on the side of the screen: photo, name, level, health, armour, mana, leader crown, Far / Down / Disconnected states.
• Minimap blips for every mate, even far away.
• Symbol over the head of nearby mates (different for the leader).
• No friendly fire between mates (weapons, melee, explosions), toggleable by the leader.
• Loot split modes: free for all, round robin, random, split, all to the leader. Usable by other resources through an export.
• Lightweight: about 0.00 ms client and server in resmon.

Works even better with NC Rift (sold separately)

If NC Rift is running, NC Dungeon can use its mob and boss engine, its EXP and its UI theme automatically. Not required.

Dependencies

Required

• FiveM server with OneSync enabled.

Included in the pack

• nc_dungeon — the dungeon script.
• nc_dungeon_assets — crypt MLO, animated chest, navmesh, mob peds, weapons, animations and effects.
• nc_party — parties, friends and loot split.

Optional (used automatically if started)

• Framework: Qbox (qbx_core), QBCore (qb-core) or ESX (es_extended) — character name, money, medical system.
• Inventory: ox_inventory or qb-inventory — item rewards.
• Target: ox_target or qb-target — otherwise a key is used.
• nc_rift — mob/boss engine, shared EXP and theme.

No ox_lib, no database.

Start order (server.cfg)

ensure nc_party

ensure nc_dungeon_assets

ensure nc_dungeon

Notes

• The crypt navmesh is built for game build 3570; with another build it has to be rebuilt. Your own dungeons can use any other interior.
• Start nc_dungeon_assets with the server only (never restart it with players online).

What you can edit

The core is protected with Cfx Asset Escrow. Config files, dungeons, NPCs, mobs, spells, sounds, loot, all 9 locale files and the bridge files (framework, inventory, notifications, death, EXP, theme) are open and fully editable. Full English README and config guide included.