PromoPlugins

✨ 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.