Other Plugin Integrations · ForgeCraft Wiki

Reward players with money on dungeon completion:

rewards:
  economy:
    enabled: true
    base-amount: 100
    per-tier-bonus: 50

DungeonForge can register a PlaceholderAPI expansion (disabled by default).

Enable it:

integrations:
  placeholderapi:
    enabled: true

Then restart the server (or run /df reload).

Available placeholders:

Placeholder	Description
`%df_class%`	Player class name
`%df_level%`	RPG level
`%df_xp%`	Current RPG XP (towards next level)
`%df_xp_next%`	XP required for next level
`%df_skill_points%`	Available skill points
`%df_skill_points_spent%`	Spent skill points
`%df_skill_points_total%`	Total earned skill points
`%df_in_dungeon%`	true/false
`%df_dungeon%`	Current dungeon name (if in run)
`%df_instance_time%`	Current run time
`%df_instance_deaths%`	Deaths in current run
`%df_best_time_<dungeonId>%`	Best time for a dungeon (rank #1)
`%df_personal_best_<dungeonId>%`	Your best time for a dungeon
`%df_lb_<dungeonId>_<rank>_name%`	Leaderboard name at a rank (1 = best)
`%df_lb_<dungeonId>_<rank>_time%`	Leaderboard time at a rank (1 = best)
`%df_rpg_enabled%`	true/false
`%df_classes_enabled%`	true/false
`%df_skills_enabled%`	true/false
`%df_hud_enabled%`	true/false

Note

In leaderboard placeholders, <dungeonId> can be the dungeon ID or the dungeon name (use underscores instead of spaces).

DungeonForge can send JSON webhooks on publish and on run end (disabled by default).

Enable it:

integrations:
  webhooks:
    enabled: true
    urls:
      - "https://your-webhook-url"
    events:
      publish: true
      run_end: true

Place Citizens NPCs in dungeons for quest givers, merchants, or lore characters. NPCs persist in dungeon templates and are cloned per instance.

Use the npc: or citizens: prefix with the NPC's numeric ID:

# MOB_SPAWN marker — place NPC #42 in the dungeon
mob-type: npc:42

💡 Finding NPC IDs

Use /npc list in-game to see IDs. Citizens must be installed and the NPC must exist before the dungeon runs.

Apply custom ModelEngine models to mobs in dungeons. The model is applied on top of a base Minecraft entity type.

Format: model:MODEL_ID:BASE_MOB — or just model:MODEL_ID (defaults to ZOMBIE).

# Apply model to a zombie base
mob-type: model:dragon_minion:ZOMBIE

# Apply model — base defaults to ZOMBIE
mob-type: meg:fire_elemental

Spawn Unbelievable Custom Monsters bosses using ucm: or boss: prefixes. See the Boss (UCM) Integration section for full details.