PromoPlugins

Minecraft 版本： 1.20.1 1.20.2 1.20.3 1.20.4 1.20.5 1.20.6 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11

平台： paper purpur spigot

标签： game-mechanics management utility

✨ Features

? Core Promo Code System

• Create unlimited promo codes with custom rewards
• Pre-configured reward templates for quick setup
• SQLite database for persistent data storage
• Usage limits and expiration controls
• Interactive GUI for statistics and management
• Purchase tracking and analytics
• Statistics export functionality

? Advanced Systems (v1.1.0)

? Requirements

• Server Software: Paper 1.20.4+ or Spigot 1.20.4+
• Java Version: Java 17 or higher
• Dependencies: None required (SQLite built-in)
• Optional: Vault for economy integration

? Installation

Quick Setup

1. Download the latest PromoPlugin.jar from Modrinth
2. Place it in your server's plugins/ folder
3. Restart your server
4. Configure plugins/PromoPlugin/config.yml as needed

That's it! The plugin will create all necessary files automatically.

? Commands

For Players

For Administrators

? Permissions

⚙️ Configuration

Main configuration file: plugins/PromoPlugin/config.yml

Example: Daily Rewards

daily-rewards:
  enabled: true
  streak-bonuses:
    7: "DIAMOND:1"
    14: "DIAMOND:3"
    30: "EMERALD:1"

Example: Discord Notifications

notifications:
  discord:
    enabled: true
    webhook-url: "YOUR_WEBHOOK_URL"

Example: Auto-Promo Codes

auto-promo-codes:
  enabled: true
  hourly:
    enabled: true
    prefix: "H"
    max-uses: 100
    price: 50.0

? Key Features Explained

? Daily Reward System

Encourage player retention with daily login rewards:

• Track consecutive login streaks
• Bonus rewards at 7, 14, and 30 days
• Fully customizable reward items
• Automatic database tracking

? Leaderboard System

Competitive player tracking:

• Top spenders leaderboard
• Top code creators leaderboard
• Real-time statistics updates
• Customizable display limits

? Auto-Promo Code Generation

Automate your promo code distribution:

• Hourly or daily automatic codes
• Unique code generation
• Customizable rewards per schedule
• Admin notifications on creation

? Multi-Channel Notifications

Stay informed across platforms:

• In-Game: Notify admins of important events
• Discord: Webhook integration for server alerts
• Telegram: Bot notifications for mobile access

? Promo Shop System

Monetize your promo codes:

• Create packaged promo code products
• Set daily purchase limits
• Custom rewards per product
• Automatic inventory management

?️ Database

PromoPlugin uses SQLite for all data storage:

Tables Created:

• promo_codes - All promo codes and settings
• transactions - Purchase records
• daily_rewards - Player streak tracking
• player_stats - Activity statistics
• leaderboard - Ranking data
• promo_shop - Shop items
• promo_purchases - Purchase history

Location: plugins/PromoPlugin/promo.db

All tables are created automatically on first launch.

? Changelog

v1.1.0 - Latest Release

• ✨ Added daily rewards system
• ✨ Added leaderboard functionality
• ✨ Added auto-promo code generation
• ✨ Added notification system (Discord, Telegram)
• ✨ Added promo shop system
• ? Fixed database connection issues
• ? Improved error handling

v1.0.0

• ✨ Initial release
• ✨ Core promo code system
• ✨ SQLite database support
• ✨ GUI statistics viewer

? Troubleshooting

Common Issues

Problem: "database connection closed"
Solution: Plugin auto-recovers connections. Ensure v1.1.0+ is installed.

Problem: Commands not working
Solution: Check permissions and ensure plugin is enabled (/plugins)

Problem: Discord notifications not sending
Solution: Verify webhook URL is valid and not expired

Problem: Promo codes not activating
Solution: Check code spelling and ensure it exists in database

? Support & Resources

• Discord_Ru: Dirscord

? License

This project is licensed under the MIT License. See LICENSE for details.

? Credits

• Developer: Muliccki
• PaperMC - For the Paper API
• Community - For testing and feedback

⭐ Star History

If you find this plugin useful, please star the repository and rate it on Modrinth! It helps others discover the plugin.