ConsumeFood2Quests

ConsumeFood2Quests
ConsumeFood2Quests adds a comprehensive quest system to your ConsumeFood2 server, turning custom food items into meaningful gameplay objectives that keep players engaged and motivated.

Core Features
Dual Quest System

• Personal Quests - Individual challenges tailored to each player
• Public Quests - Server-wide objectives that encourage community participation

Seamless Integration

• Automatically reads your existing ConsumeFood2 configurations
• No duplicate setup required - works with your current custom foods
• Zero-dependency design (optional Vault support for economy features)

Flexible Interaction

• GUI Mode - Intuitive graphical interface for easy quest management
• Command Mode - Traditional text-based commands for power users
• Full tab completion for all commands

Smart Quest Generation

• Template-based system with weighted probabilities
• Configurable difficulty and reward distributions
• Time-limited challenges with automatic cleanup
• Customizable quest pools for different scenarios

Advanced Security System

• Anti-cheat protection prevents item duplication
• Secure item verification using NBT data comparison
• Prevents fake item submissions through name changes
• Virtual inventory system ensures plugin compatibility

Configuration
Modular Setup

• config.yml - Core plugin settings and behavior control
• tasks.yml - Quest generation templates and parameters
• rewards.yml - Reward pool definitions with probability weights
• lang.yml - Complete localization support (easily translate to any language)

Reward System

• Economy integration (Vault API support)
• Custom command execution rewards
• Multiple reward pools with different rarities
• Configurable probability distributions

Key Benefits
For Server Owners

• Instant gameplay value from existing custom food items
• No additional content creation required
• Hot-reloadable configurations for live adjustments
• Comprehensive admin tools for quest management
• Built-in anti-cheat and security measures

For Players

• Clear objectives that showcase server's unique content
• Choice between GUI and command interfaces
• Social elements through public quest participation
• Meaningful progression with customizable rewards
• Fair and secure quest completion system

Commands & Permissions
Player Commands

• /fq - Open quest GUI or view quest list
• /fq abandon <number> - Abandon personal quests
• /fq submit - Submit quest items (command mode)

Admin Commands

• /fq reload - Reload all configurations
• /fq newtask <player> - Manually assign personal quests
• /fq newtask public - Create public quests
• /fq removepublic <number> - Remove public quests

Permissions

• cfq.user - Basic quest access (default: true)
• cfq.admin - Administrative commands (default: op)

Installation

1. Ensure ConsumeFood2 is installed and working
2. Download ConsumeFood2Quests.jar
3. Place in your plugins folder
4. Restart server - configurations generate automatically
5. Customize quest templates in tasks.yml as desired

Technical Details

• API Version: 1.17+
• Dependencies: ConsumeFood2 (required), Vault (optional)
• Memory Usage: Minimal - all data stored in memory with automatic cleanup
• Performance: Lightweight with efficient quest generation algorithms
• Security: Advanced NBT-based item verification system

Localization
Full multi-language support through lang.yml:

• All messages, formats, and UI text customizable
• Easy translation to any language
• Supports color codes and formatting
• Time display formats configurable

Quest System Details
Quest Generation

• Weighted template system for balanced difficulty
• Automatic food selection from your ConsumeFood2 items
• Configurable quest objectives (single/multiple foods)
• Time limits with automatic expiration handling

Progress Tracking

• Real-time inventory scanning with secure item matching
• Accurate verification including NBT data, lore, display names, and custom model data
• Visual progress indicators in GUI
• Time remaining display for limited quests

Security Features

• Prevents item duplication during quest operations
• Anti-cheat system blocks fake item submissions
• Compatible with inventory protection plugins
• Secure virtual inventory system for item verification

Community
This add-on is officially recognized by the ConsumeFood2 developer and will be featured on the ConsumeFood2 Spigot page.

Support & Feedback

• Report issues or request features in the discussion section
• Configuration help and setup assistance available
• Regular updates to maintain compatibility

Turn your custom food into an engaging quest experience with enterprise-level security!

该插件默认配置语言为中文，但全部文本皆可翻译
The default configuration language of this plugin is Chinese, but all texts can be translated