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.
<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
๐ Requirements
- Alliance Auth v4.0+
- Alliance Auth Corp Tools - For wallet integration
- AA Discord Notify (Optional) - For Discord notifications
๐ 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.
๐ฎ How to Use
For Players
- ๐ Find Active Lotteries - Check the lottery page to see what's currently running
- ๐ซ Buy Tickets - Send ISK to the specified corporation with the lottery reference in the reason
- ๐ Track Progress - Monitor your tickets and see real-time lottery statistics
- ๐ Check Results - Winners are announced automatically via Discord and notifications
For Administrators
- โ Create Lotteries - Set ticket prices, duration, winners, and prize distribution
- ๐ Setup Recurring Lotteries - Configure automated lotteries that repeat on schedule
- ๐ Monitor Activity - Watch real-time participant counts and revenue tracking
- ๐ง Resolve Issues - Use advanced tools to handle payment anomalies
- ๐ฐ Distribute Prizes - Track and confirm prize distributions to winners
๐ธ Screenshots
๐ฒ User Experience
FortunaISK in Action | Personal Dashboard |
---|---|
![]() |
![]() |
Complete lottery system overview | Track tickets, winnings, and payments |
Lottery History
Browse past lotteries with detailed results and statistics
๐ ๏ธ Admin Interface
Admin Dashboard | Lottery Details |
---|---|
![]() |
![]() |
Real-time statistics and monitoring | Participant tracking and anomaly resolution |
๐ Results & ๐ Discord Integration
Winner Announcements | Discord Notifications |
---|---|
![]() |
![]() |
Transparent prize distribution | Rich embeds for community engagement |
24-Hour Closure Reminders |
---|
![]() |
Automated reminders to boost participation before lottery closure |
๐ 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
๐ 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.
๐ค Contributing
We welcome contributions! Whether it's bug fixes, new features, or documentation improvements:
- ๐ด Fork the repository
- ๐ฟ Create your feature branch:
git checkout -b feature/amazing-feature
- ๐ Commit your changes:
git commit -m 'Add amazing feature'
- ๐ Push to the branch:
git push origin feature/amazing-feature
- ๐ฌ 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
๐ 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
- aa-discordnotify>=2
- allianceauth<5,>=4
- allianceauth-corptools>=2.5.5
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
Please login to see more options.