PvE tool for AllianceAuth
Free software: GNU General Public License v3
This package aims at helping groups of people manage PvE sessions, centralized loot management and loot taxes.
Rotations are a sort of containers for entries. When created, they have some options to customize the behavior of the tool with the entries, such as tax rate, count of setups of the system before ratting etc.
They can be created by the people with the right permission (see below). For them, a button will be avaiable in the main page. It'll lead to a form for creating a rotation.
| Field | Description |
|---|---|
| Name | |
| Priority | The priority for the rotation in the list of active rotations. Rotations are displayed in descending order of priority. |
| Tax rate | Tax rate in percentage. 0 for disabling taxes. |
| Max daily setups | The maximum number of helped setups a user can get per day. This option is thought for wormholes where you should setup a system before ratting in it. Set to 0 for disabling tracking setups. Defaults to 1. |
| Min people share setup | The minimum number of users in an entry for considering the setups valid. Defaults to 3 |
| Entry buttons | Custom buttons to be shown in the Entry forms. You can select them by holding Ctrl and left-clicking. The package comes with buttons for the main C5 and C6 wormhole. sites. |
| Roles setups | Roles presets for Entry forms. You can select them by holding Ctrl and left-clicking. |
Entries are the corrisponding of an actual PvE fleet. They consist in an estimated total loot value and a set of shares. When an Entry is submitted to a rotation, all the rules of tax rate and setups are applied and the loot value is split between the participants according to their share weight. To add an entry to a rotation, click on the plus button on the bottom left of the screen.
Every entry has a list of shares. To add a share, search for the character you want to add in the panel on the right and click the add button.
A share will be added with the first role in the list, 1 site count and no setup. Setups are helpful in wormholes when you want to track who helped setting up a system before ratting. Roles defines how loot will be split between the shares: for example, if someone has 1 site count and a role with a value of 1 and someone else has 1 site count and a role with a value of 2, this last person will receive double the amount of money of the first one.
In order to add a role, you can click on the New Role button and create one from scratch or load a roles setup, if you chose at least one in the rotation form, by clicking on the Load Roles Setup button.
When you have a role loaded, you can choose it from the dropdown select on the shares.
On the center of the right panel there is the Estimated total section. There is a numeric field and a list of buttons if you selected at least one in the rotation form. you can either input the estimated total by hand or click on the buttons while you are running the sites.
On the right of the Estimated total field there are 4 buttons for incrementing the site count of the shares. If you hover each of them there'll be a tooltip telling what each button does. The ones that change selected chars only edit the shares with the green arrow. This is helpful if you are doing the form while you are running the sites: if a person leaves, you can click on the arrow and it'll be unselected.
Once you have submitted the entry, you'll see updating the summary and the entry list on the rotation page. You can edit an entry by clicking the arrow on the right of the row in the entry list and then click on the edit button.
When the loot is sold, a person with the right permission (see below) can close the rotation and insert the sales value in the form. Then the closed rotation page will be shown with the right amount of money to send to each person, calculated on the sales value.
You can see all the closed rotations from the dashboard.
In the dashboard, there is a section for funding projects. People with the appropriate permission (see below) can create projects and add them to the list. When adding entries, an active funding project can be selected with a percentage of the entry to be added to the project. The money will be added to the project total once the rotation is closed.
In each project page, there is a list of the people who have contributed to the project and the total amount of money they have contributed and the current completion percentage of the project.
Projects need to be closed manually by people with the appropriate permission and they will not appear during entry creation.
In a closed rotation summary, you can click on a character name and on an actual total to copy their value. Once you do so, the corresponding row in the table will be of a different color to help tracking down who is already being copied. To reset a row color, click on the X button on the right of the row.
Buttons and roles setups can be created in the admin page by people who have access.
Rotation presets can be created in the admin page by people who have access. They can be used to ensure a rotation with a certain name is always open with the specified settings.
| Setting | Default | Description |
|---|---|---|
PVE_ONLY_MAINS | False | When set to True, only main characters are shown in search bar |
This modeling is based on how whormoles fleets and loot are managed. If you have some feature requests for other types of environment, pls join AllianceAuth discord and give me a shout in the #pve-tool channel. I don't have any experience in anything except whormholes so any help is appriciated.
The following is assuming you have a functioning AllianceAuth installation.
pip install allianceauth-pveallianceauth_pve (note the underscore) to your INSTALLED_APPSpip install -U allianceauth-pveThe following permissions are provided:
access_pve: only users with this permission can see the tool and be added in entries.manage_entries: only users with this permissions can create entries.manage_rotations: only users with this permissions can create and close rotations.manage_funding_projects: only users with this permissions can create and close funding projects.You'll have to assign this permissions to desired groups/states to make the tool work.
From an original idea of iRBlue.
This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.
FAQs
PvE tool for AllianceAuth
We found that allianceauth-pve demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Research
The Socket Research Team breaks down a malicious wrapper package that uses obfuscation to harvest credentials and exfiltrate sensitive data.
Research
Security News
Attackers used a malicious npm package typosquatting a popular ESLint plugin to steal sensitive data, execute commands, and exploit developer systems.
Security News
The Ultralytics' PyPI Package was compromised four times in one weekend through GitHub Actions cache poisoning and failure to rotate previously compromised API tokens.