TaczQuestCreator - CurseForge Description
Full Description
# TaczQuestCreator
A comprehensive quest board system designed for multiplayer servers running Minecraft Forge 1.20.1.
TaczQuestCreator provides a fully featured, server-authoritative quest framework with a rotating quest board, premium
rewards, difficulty scaling, and deep integration with popular mods.
---
## Features
### Quest Board
- Rotating quest board with **6 normal slots** and **3 premium slots** (configurable)
- Auto-refreshes on a configurable timer (default: 30 minutes)
- Manual refresh via admin command
- Players can hold up to **3 active quests** simultaneously (configurable)
- Beautiful dark-themed UI with difficulty stars, target icons, and reward previews
### 6 Quest Types
- **Collect Items** — Gather specific items (auto-detected from inventory)
- **Kill Entities** — Slay mobs or specific entity types
- **Gun Kill** — Kill entities with TACZ firearms, optionally filtered by weapon type (requires TACZ)
- **Survive Waves** — Survive defense waves in clan zones (requires Clans System)
- **Capture** — Complete KOTH or city capture events (requires Clans System)
- **Extract** — Successfully complete extraction objectives (requires Clans System)
### Multi-Target Quests
A single quest can require multiple objectives (e.g., "Kill 5 Zombies AND 3 Skeletons"). Each target tracks progress
independently and all must be completed to finish the quest.
### Flexible Reward System
- **Item rewards** with full NBT support (enchantments, custom model data, lore, etc.)
- **Experience rewards**
- **Command rewards** (execute any server command on completion)
- **Drop chance** per reward (0–100%) for randomized loot
- All rewards scale with difficulty and premium tier
### Difficulty Scaling
- Quests support a **1–5 star difficulty** rating
- Optional **random difficulty** — each board refresh rolls a new difficulty
- Target amounts, rewards, time limits, costs, and money rewards all scale automatically
### Premium Tier System
- **3 tiers**: Normal (1x), Premium (1.5x), VIP (2.0x) — multipliers are configurable
- Premium-exclusive quest slots on the board
- Reward multipliers applied to all reward types
- Assign tiers via command or permission nodes
### Economy Integration
- **Command mode** (default): Works with any economy plugin (Vault, EssentialsX, etc.) via configurable commands
- **HudCreator mode**: Direct API integration with HudCreator's economy system
- Quest accept costs and money rewards, both scaled by difficulty
### HUD Overlay
- Persistent on-screen display of active quests
- Shows quest name, progress bar, and remaining time
- Fully repositionable via config
- Can be toggled on/off
### Admin Tools
- In-game GUI for **creating, editing, listing, enabling/disabling, and deleting** quests
- **JSON export/import** — back up your quests or share them between servers
- `/questadmin reload` to hot-reload quest definitions without restart
- `/questadmin refresh` to manually refresh the quest board
---
## Commands
| Command | Permission | Description |
| `/questboard` | Everyone | Opens the quest board |
| `/questadmin create` | OP (level 2) | Opens the quest creation GUI |
| `/questadmin list` | OP (level 2) | Lists all quests with admin controls |
| `/questadmin reload` | OP (level 2) | Reloads quests from JSON files |
| `/questadmin export` | OP (level 2) | Exports all quests to JSON |
| `/questadmin refresh` | OP (level 2) | Forces a board refresh |
| `/questadmin setpremium <player> <0|1|2>` | OP (level 2) | Sets a player's premium tier |
---
## Configuration
All settings are available in `taczquestcreator-common.toml`:
- **Board refresh interval** (default: 30 minutes)
- **Normal & premium quest slot counts**
- **Max active quests per player**
- **Default quest duration**
- **Premium system toggle & multipliers**
- **Economy mode & commands**
- **HUD toggle & position**
---
## Compatibility
### Minecraft & Forge
- **Minecraft**: 1.20.1
- **Forge**: 47.2.0+
### Supported Mod Integrations (Optional)
| Mod | Integration |
|---|---|
| **TACZ (Timeless and Classics Guns)** | Enables the "Gun Kill" quest type — track kills by weapon type |
| **Clans System** | Enables "Survive Waves", "Capture", and "Extract" quest types with group progress |
| **HudCreator** | Direct economy API integration as an alternative to command-based economy |
All integrations are **optional** and loaded conditionally. The mod works standalone with Collect Items and Kill
Entities quest types.
### Economy Compatibility
Works with **any economy plugin** that supports server commands (Vault, EssentialsX, etc.) via the configurable
command mode.
---
## Technical Details
- **Server-authoritative architecture** — all quest logic runs server-side; clients maintain a read-only cache
- **14 optimized network packets** for efficient client-server synchronization
- **Per-player capability storage** for quest progress persistence
- **World-level SavedData** for quest definitions and board state
- **Secure**: All actions validated server-side before execution
---
## For Server Owners
TaczQuestCreator is built for multiplayer servers. It provides a plug-and-play quest system that:
- Keeps players engaged with rotating, difficulty-scaled objectives
- Supports monetization via the premium tier system
- Integrates with your existing economy setup
- Gives admins full control through in-game GUIs and commands
- Persists all data across restarts with no external database required
---
