{"id":14969630,"url":"https://github.com/nikosgram/gringotts","last_synced_at":"2025-09-29T19:30:56.692Z","repository":{"id":38002014,"uuid":"165851690","full_name":"nikosgram/gringotts","owner":"nikosgram","description":"Gringotts is an item-based economy plugin for the Bukkit Minecraft server platform. Unlike earlier economy plugins, all currency value and money transactions are based on actual items in Minecraft, per default emeralds.","archived":false,"fork":true,"pushed_at":"2024-08-30T10:49:22.000Z","size":4811,"stargazers_count":42,"open_issues_count":26,"forks_count":35,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-09-13T19:56:46.097Z","etag":null,"topics":["bukkit","bukkit-plugin","economy","economy-plugin","gringotts","hacktoberfest","item-based-economy","minecraft","minecraft-mod","minecraft-plugin","paperclip","papermc","plugin","spigot","spigot-plugin","spigotmc"],"latest_commit_sha":null,"homepage":"https://www.spigotmc.org/resources/gringotts.42071/","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"MinecraftWars/Gringotts","license":"bsd-2-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nikosgram.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null},"funding":{"github":["nikosgram"],"custom":"https://www.paypal.me/lordgram"}},"created_at":"2019-01-15T13:02:04.000Z","updated_at":"2024-08-30T10:48:31.000Z","dependencies_parsed_at":"2023-02-18T03:31:35.363Z","dependency_job_id":null,"html_url":"https://github.com/nikosgram/gringotts","commit_stats":null,"previous_names":[],"tags_count":16,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nikosgram%2Fgringotts","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nikosgram%2Fgringotts/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nikosgram%2Fgringotts/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nikosgram%2Fgringotts/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nikosgram","download_url":"https://codeload.github.com/nikosgram/gringotts/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":219543874,"owners_count":16504766,"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":["bukkit","bukkit-plugin","economy","economy-plugin","gringotts","hacktoberfest","item-based-economy","minecraft","minecraft-mod","minecraft-plugin","paperclip","papermc","plugin","spigot","spigot-plugin","spigotmc"],"created_at":"2024-09-24T13:42:08.636Z","updated_at":"2025-09-29T19:30:56.686Z","avatar_url":"https://github.com/nikosgram.png","language":"Java","funding_links":["https://github.com/sponsors/nikosgram","https://www.paypal.me/lordgram"],"categories":[],"sub_categories":[],"readme":"Gringotts [![Java CI with Maven](https://github.com/nikosgram/gringotts/actions/workflows/maven.yml/badge.svg)](https://github.com/nikosgram/gringotts/actions/workflows/maven.yml) [![Maven Package](https://github.com/nikosgram/gringotts/actions/workflows/maven-publish.yml/badge.svg)](https://github.com/nikosgram/gringotts/actions/workflows/maven-publish.yml)\n=========\n\nGringotts is an item-based economy plugin for the Spigot Minecraft server platform. Unlike earlier economy plugins, all\ncurrency value and money transactions are based on actual items in Minecraft, per default emeralds. The goals are to add\na greater level of immersion, a generally more Minecraft-like feeling, and in the case of a PvP environment, making the\ncurrency itself vulnerable to raiding.\n\n\n### ⚠ Breaking Changes in Version 3.0.0\n\nThis version changed the way data are stored, so if you come from an older version of Gringotts, you need to manually update your database.\n\n- Shutdown your server\n- In your plugins folder, open the folder named `Gringotts`\n- Make a copy of the file `Gringotts.db` in case something goes wrong during the update.\n- Install sqlite3 command-line program, on linux you can do so by entering the following in the terminal `sudo apt install sqlite3`\n(for windows refer to [this link](https://www.sqlite.org/cli.html))\n- Open your terminal in Gringotts' directory and enter this command `sqlite3 Gringotts.db`\n- In the shell enter the following instructions\n```\nCREATE TABLE db_migration (\n  id                           integer not null,\n  mchecksum                    integer not null,\n  mtype                        varchar(1) not null,\n  mversion                     varchar(150) not null,\n  mcomment                     varchar(150) not null,\n  mstatus                      varchar(10) not null,\n  run_on                       timestamp not null,\n  run_by                       varchar(30) not null,\n  run_time                     integer not null,\n  constraint pk_db_migration primary key (id)\n);\n```\nExecute and then enter\n`INSERT INTO db_migration VALUES(0,0,'I','0','\u003cinit\u003e','SUCCESS',1721777343415,'foo',0);`\nand\n`INSERT INTO db_migration VALUES(1,-1450547331,'V','1.0','initial','SUCCESS',1721777343415,'foo',1);`\n\n- If everything went smoothly you should be done, exit sqlite by typing `.exit`, replace gringotts.jar by the new version and start your server.\n\n\u003e You may get the error `Error: attempt to write a readonly database`, that means that your user doesn't have write permission for the file Gringotts.db.\n\n\u003e On the first launch you will get lot of `Balance differs for account` errors, they can be ignored. If you get one after that, please open an issue as it may indicate a money duplication glitch.\n\n\n### Get Gringotts\n\n- [from Spigot](https://www.spigotmc.org/resources/gringotts.42071/)\n- [from Hangar](https://hangar.papermc.io/nikosgram/Gringotts)\n\nFeatures\n--------\n\n* Item-backed economy (configurable, default emeralds)\n* Multiple denominations with automatic conversion (for example, use emeralds and emerald blocks)\n* Storage of currency in chests and other containers, player inventory and ender chests (configurable)\n* Direct account-to-account transfers commands\n* Optional transaction taxes\n* Fractional currency values (fixed decimal digits)\n* [Vault](https://www.spigotmc.org/resources/vault.34315/) integration\n\nUsage\n-----\nStoring money in an account requires a Gringotts vault. A vault consists of a container, which can be either chest,\ndispenser or furnace, and a sign above or on it declaring it as a vault. A player may claim any number of\nvaults. Vaults are not protected from access through other players. If you would like them to be, you may use additional\nplugins such as [LWC](https://dev.bukkit.org/projects/lwc/) or [WorldGuard](https://dev.bukkit.org/projects/worldguard/)\n.\n\n[Read how to use gringotts](https://github.com/nikosgram/Gringotts/wiki/Usage).\n\nConfiguration\n-----\nRead [how to config gringotts](https://github.com/nikosgram/Gringotts/wiki/Configuration).\n\nPermissions\n-----\nRead [how gringotts permissions works](https://github.com/nikosgram/Gringotts/wiki/Permissions).\n\nCommands\n--------\nRead [how to use gringotts commands](https://github.com/nikosgram/Gringotts/wiki/Commands).\n\nInstallation and Configuration\n------------------------------\nDownload [Gringotts](https://www.spigotmc.org/resources/gringotts.42071/) and place it in your craftbukkit/plugins\nfolder\n\nPlease see the [Configuration](https://github.com/nikosgram/Gringotts/wiki/Permissions)\nand [Permissions](https://github.com/nikosgram/Gringotts/wiki/Permissions) document on how to configure Gringotts.\n\nProblems? Questions?\n--------------------\nHave a look at the [Wiki](https://github.com/nikosgram/Gringotts/wiki). You're welcome to improve it, too!\n\nDevelopment\n-----------\nWould you like to make changes to Gringotts yourself? Fork it!\nPull requests are very welcome, but please make sure your changes fulfill the Gringotts quality baseline:\n\n* new features, settings, permissions are documented\n* required dependencies are all added to the build by Maven, not included in the repo\n* the project builds with Maven out-of-the-box\n\nGringotts uses the [Maven 3](http://maven.apache.org/) build system. Build a working plugin jar with the command\n\n```shell\nmvn compile install\n```\n\nMetrics\n-------\n[![Gringotts Metrics](https://bstats.org/signatures/bukkit/Gringotts.svg)](https://bstats.org/plugin/bukkit/Gringotts/4998)\n\n## Contributors\n\n\u003ca href=\"https://github.com/nikosgram/gringotts/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contrib.rocks/image?repo=nikosgram/gringotts\"  alt=\"Gringotts contributors\"/\u003e\n\u003c/a\u003e\n\nMade with [contrib.rocks](https://contrib.rocks/preview?repo=nikosgram%2Fgringotts)\n\nLicense\n-------\nAll code within Gringotts is licensed under the BSD 2-clause license. See `license.txt` for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnikosgram%2Fgringotts","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnikosgram%2Fgringotts","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnikosgram%2Fgringotts/lists"}