{"id":20208672,"url":"https://github.com/alexpresso/zunivers-ninja","last_synced_at":"2026-02-13T22:32:37.581Z","repository":{"id":41773405,"uuid":"420819440","full_name":"AlexPresso/ZUnivers-Ninja","owner":"AlexPresso","description":"Automated advice tool for the ZUnivers card game (not affiliated)","archived":false,"fork":false,"pushed_at":"2025-01-30T23:07:49.000Z","size":272,"stargazers_count":1,"open_issues_count":1,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-24T11:45:08.689Z","etag":null,"topics":["advice","discord","webhooks","zerator","zunivers"],"latest_commit_sha":null,"homepage":"https://zunivers.zerator.com","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AlexPresso.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-10-24T23:25:08.000Z","updated_at":"2025-01-30T23:07:37.000Z","dependencies_parsed_at":"2024-07-31T23:44:20.930Z","dependency_job_id":"601259f2-81fe-49eb-a054-6490171650a4","html_url":"https://github.com/AlexPresso/ZUnivers-Ninja","commit_stats":null,"previous_names":[],"tags_count":23,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexPresso%2FZUnivers-Ninja","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexPresso%2FZUnivers-Ninja/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexPresso%2FZUnivers-Ninja/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexPresso%2FZUnivers-Ninja/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AlexPresso","download_url":"https://codeload.github.com/AlexPresso/ZUnivers-Ninja/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248222567,"owners_count":21067805,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["advice","discord","webhooks","zerator","zunivers"],"created_at":"2024-11-14T05:36:34.300Z","updated_at":"2026-02-13T22:32:32.551Z","avatar_url":"https://github.com/AlexPresso.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\u003cimg alt=\"logo\" src=\"https://repository-images.githubusercontent.com/420819440/51db7016-b325-4d1b-a1d3-ce82d771f58b\" height=\"320px\"\u003e\n\u003c/div\u003e\n\nThis project aims to suggest to one (or more) users: the best actions scenario to take.\nIt's currently based on a recursive method which always tries projections until it cannot do anything more than the previous iteration. \n\nI'm planning to move the projection system to a tree calculation system, generating all possible scenarios and returning the one providing the best score. \n\n## Disclaimer\n\nThis project is not affiliated with the ZUnivers's project. It's a community project.\n\n## Features\n- ✅ `!journa` projection\n- ✅ `!recycle` projection\n- ✅ `!fusion` projection\n- ✅ `!upgrade` projection\n- ✅ `!im` projection (with boosters and current event priority)\n- ✅ `!craft` projection\n- ✅ `!ascension` projection\n- ✅ challenges projection\n- ✅ evolution projection\n- ✅ constellation projection\n- ✅ 'chromas' projection\n- ✅ corporations projection\n- ✅ plugin system\n- (Soon) auto subscription based on a rentability check\n\n\n## Usage / Deployment\n- [Kubernetes](#kubernetes)\n- [Docker](#docker)\n- [Manual deployment](#manual-deployment)\n\n## Kubernetes\nFor Kubernetes clusters, there is a helm chart available in [helm.alexpresso.me](https://github.com/AlexPresso/helm.alexpresso.me), see default [values.yaml file](https://github.com/AlexPresso/helm.alexpresso.me/blob/main/charts/zunivers-ninja/values.yaml)\n\n## Docker\n- Download the `docker-compose.yml` file ([docker-compose.yml example](https://github.com/AlexPresso/ZUnivers-Ninja/blob/main/docker-compose.yml))\n- Set a Neo4J password in `docker-compose.yml` (i.e: `NEO4J_AUTH=neo4j/MyVeryStrongPassword`)\n  - Don't forget to put the same password for zunivers-ninja's `NEO4J_PASSWORD`\n- (Optional) Set a Discord Webhook endpoint if you want to receive advices directly inside a Discord Channel.\n- Run `docker compose up -d`\n\n## Manual deployment\n- Setup a Neo4J database ([docker-image](https://hub.docker.com/_/neo4j))\n- (Choose between A or B):\n  - A. Clone the repo and build the jar with `mvn package`\n  - B. Download the `zunivers-ninja-\u003cversion\u003e-exec.jar` from the [package artifacts page](https://github.com/AlexPresso/ZUnivers-Ninja/packages/1071646) \n- Create a `/config` directory next to the built jar\n- Create a `/config/application.yml` file ([config file example](https://github.com/AlexPresso/ZUnivers-Ninja/blob/main/src/main/resources/application.yml))\n- Run the app (`java -jar zunivers-ninja-\u003cversion\u003e-exec.jar` or `mvn spring-boot:run`)\n\n## Making plugins\nThe app supports plugins, by loading every jar files in a `/plugins` directory.  \nSee the [zuninja-plugin-example](https://github.com/AlexPresso/ZUnivers-Ninja/tree/main/zuninja-plugin-example) project.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexpresso%2Fzunivers-ninja","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falexpresso%2Fzunivers-ninja","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexpresso%2Fzunivers-ninja/lists"}