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

---

## 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

---

[TACZ] QuestCreator