Browse Apps

Fortuna-ISK

fortunaisk Plugin for Alliance Auth


FortunaISK

A comprehensive lottery system for Alliance Auth that brings excitement and community engagement to your corporation or alliance. Run fair, transparent lotteries with automated management and real-time tracking.

License: MIT Python 3.8+ Django 4.0+

<hr />

โœจ Features

๐ŸŽฒ Easy Lottery Participation

  • Simple ISK Transfer System - Just send money with the lottery reference in the reason
  • Real-time Ticket Tracking - Monitor your purchases and remaining allowances
  • Personal Dashboard - Complete history of tickets, winnings, and payments
  • Automatic Notifications - Get notified instantly when you win

๐Ÿ† Flexible Prize Distribution

  • Multi-winner Support - Configure multiple winners per lottery
  • Custom Prize Percentages - Set exact prize distribution for each winner
  • Automated Calculations - System handles all prize calculations automatically
  • Transparent Results - Public winner announcements with full details

โšก Automated Management

  • Recurring Lotteries - Set up lotteries that run automatically on schedule
  • Smart Payment Processing - Automated validation and anomaly detection
  • Lifecycle Management - Automatic transitions from active to completed
  • 24-hour Reminders - Automated closure notifications

๐Ÿ“Š Administrative Excellence

  • Rich Admin Dashboard - Real-time statistics and system monitoring
  • Anomaly Resolution - Advanced tools to handle payment discrepancies
  • Prize Distribution Tracking - Monitor and confirm prize deliveries
  • Comprehensive Audit Trails - Complete logging of all actions
  • CSV Export - Export participant and winner data

๐Ÿ”” Discord Integration

  • Rich Notifications - Beautiful embeds for all lottery events
  • Winner Announcements - Automatic celebration of lottery results
  • Admin Alerts - Immediate notification of anomalies or issues
  • Customizable Webhooks - Configure notifications for your community
<hr />

๐Ÿ“‹ Requirements

<hr />

๐Ÿš€ Installation

Step 1 - Install the Package

pip install fortunaisk

Step 2 - Configure Settings

Add the following to your Alliance Auth's local.py:

# Add to INSTALLED_APPS
INSTALLED_APPS += [
    "fortunaisk",
]

Step 3 - Finalize Installation

python manage.py migrate
python manage.py collectstatic

Restart your Alliance Auth instance:

supervisorctl restart all

Step 4 - Setup Permissions

Visit your admin interface and assign permissions to appropriate groups:

Permission Purpose
fortunaisk \| Can access FortunaISK Basic lottery participation
fortunaisk \| Can admin FortunaISK Full administrative access

Step 5 - Configure Discord (Optional)

Visit /admin/fortunaisk/webhookconfiguration/ to set up Discord notifications.

<hr />

๐ŸŽฎ How to Use

For Players

  1. ๐Ÿ” Find Active Lotteries - Check the lottery page to see what's currently running
  2. ๐ŸŽซ Buy Tickets - Send ISK to the specified corporation with the lottery reference in the reason
  3. ๐Ÿ“Š Track Progress - Monitor your tickets and see real-time lottery statistics
  4. ๐Ÿ† Check Results - Winners are announced automatically via Discord and notifications

For Administrators

  1. โž• Create Lotteries - Set ticket prices, duration, winners, and prize distribution
  2. ๐Ÿ”„ Setup Recurring Lotteries - Configure automated lotteries that repeat on schedule
  3. ๐Ÿ“ˆ Monitor Activity - Watch real-time participant counts and revenue tracking
  4. ๐Ÿ”ง Resolve Issues - Use advanced tools to handle payment anomalies
  5. ๐Ÿ’ฐ Distribute Prizes - Track and confirm prize distributions to winners
<hr />

๐Ÿ“ธ Screenshots

๐ŸŽฒ User Experience

FortunaISK in Action Personal Dashboard
FortunaISK Overview User Dashboard
Complete lottery system overview Track tickets, winnings, and payments

Lottery History Lottery History Browse past lotteries with detailed results and statistics

๐Ÿ› ๏ธ Admin Interface

Admin Dashboard Lottery Details
Admin Dashboard Lottery Details
Real-time statistics and monitoring Participant tracking and anomaly resolution

๐Ÿ† Results & ๐Ÿ”” Discord Integration

Winner Announcements Discord Notifications
Winner Results New Lottery Discord
Transparent prize distribution Rich embeds for community engagement
24-Hour Closure Reminders
24h Reminder Discord
Automated reminders to boost participation before lottery closure
<hr />

๐Ÿ†• Latest Updates

Version 1.0.0 - Stable Release! ๐ŸŽ‰

  • โœ… Multi-winner lottery support with custom prize distribution
  • โœ… Automated recurring lotteries with flexible scheduling
  • โœ… Enhanced admin dashboard with real-time statistics
  • โœ… Advanced anomaly detection and resolution
  • โœ… Comprehensive Discord integration
  • โœ… CSV export functionality
  • โœ… Complete audit trails and security improvements

What's Coming Next

  • ๐ŸŽ Physical prize lottery support
<hr />

๐Ÿ”„ Updating

Step 1 - Update Package

pip install -U fortunaisk

Step 2 - Apply Changes

python manage.py migrate
python manage.py collectstatic
supervisorctl restart all

โš ๏ธ Important for v0.6.6+ users: Discord webhook configuration has changed. Please reconfigure your webhooks at /admin/fortunaisk/webhookconfiguration/ after updating.

<hr />

๐Ÿค Contributing

We welcome contributions! Whether it's bug fixes, new features, or documentation improvements:

  1. ๐Ÿด Fork the repository
  2. ๐ŸŒฟ Create your feature branch: git checkout -b feature/amazing-feature
  3. ๐Ÿ“ Commit your changes: git commit -m 'Add amazing feature'
  4. ๐Ÿš€ Push to the branch: git push origin feature/amazing-feature
  5. ๐Ÿ“ฌ Submit a pull request

For major changes, please open an issue first to discuss your ideas.

<hr />

๐Ÿ†˜ Support

  • ๐Ÿ“š Documentation: View the full documentation
  • ๐Ÿ› Bug Reports: Report issues
  • ๐Ÿ’ฌ Community: Join the Alliance Auth Discord for support
  • โœ‰๏ธ Contact: Reach out to the maintainer for direct support
<hr />

๐Ÿ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

<hr />

FortunaISK - Bringing fair and exciting lotteries to your Alliance Auth community! ๐ŸŽฒโœจ

Made with โค๏ธ for the EVE Online community

No reviews yet...

Python Requirements

Required Python packages to be installed and other Python requirement.

App Dependencies


Required apps:

Used by apps:

    -

Dependencies to other apps registered in this app directory.

Classifiers

  • Environment :: Web Environment
  • Framework :: Celery
  • Framework :: Django
  • Framework :: Django :: 4.0
  • Framework :: Django :: 4.2
  • Intended Audience :: Developers
  • License :: OSI Approved :: MIT License
  • Operating System :: OS Independent
  • Programming Language :: Python
  • Programming Language :: Python :: 3 :: Only
  • Programming Language :: Python :: 3.10
  • Programming Language :: Python :: 3.11
  • Programming Language :: Python :: 3.12
  • Programming Language :: Python :: 3.13
  • Programming Language :: Python :: 3.8
  • Programming Language :: Python :: 3.9
  • Programming Language :: Python :: Implementation :: CPython
  • Topic :: Internet :: WWW/HTTP
  • Topic :: Internet :: WWW/HTTP :: Dynamic Content

Version

1.1.0

License

MIT License

PyPI

  https://pypi.org/project/fortunaisk/

Last updated

5ย days, 20ย hours ago

First published

5ย months ago

Category

Plugin Apps

Rating

-

Authors

erka Ekanon

Maintainers

erka Ekanon erka Ekanon

Please login to see more options.