{"id":18991271,"url":"https://github.com/mt-mods/xp_redo","last_synced_at":"2025-04-22T11:37:06.369Z","repository":{"id":45479258,"uuid":"133771499","full_name":"mt-mods/xp_redo","owner":"mt-mods","description":"XP Mod for minetest","archived":false,"fork":false,"pushed_at":"2024-10-04T09:47:48.000Z","size":5106,"stargazers_count":5,"open_issues_count":13,"forks_count":11,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-04-17T00:16:56.371Z","etag":null,"topics":["experience","minetest","mod","xp"],"latest_commit_sha":null,"homepage":null,"language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-2.1","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mt-mods.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","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}},"created_at":"2018-05-17T06:51:27.000Z","updated_at":"2024-10-04T09:47:49.000Z","dependencies_parsed_at":"2024-02-27T23:22:57.560Z","dependency_job_id":"ac60bbce-375b-4dc6-b356-c8dd3385f309","html_url":"https://github.com/mt-mods/xp_redo","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mt-mods%2Fxp_redo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mt-mods%2Fxp_redo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mt-mods%2Fxp_redo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mt-mods%2Fxp_redo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mt-mods","download_url":"https://codeload.github.com/mt-mods/xp_redo/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250234212,"owners_count":21396952,"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":["experience","minetest","mod","xp"],"created_at":"2024-11-08T17:13:22.959Z","updated_at":"2025-04-22T11:37:06.349Z","avatar_url":"https://github.com/mt-mods.png","language":"Lua","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Minetest XP mod (xp_redo)\n\n[![luacheck](https://github.com/mt-mods/xp_redo/actions/workflows/luacheck.yml/badge.svg)](https://github.com/mt-mods/xp_redo/actions/)\n\nMinetest mod for player experience management (xp)\nIt adds an xp counter per player and ranks according to your xp level.\nThe xp level, your rank and a progress bar to the next rank will show up in your hud.\nOn every rank level up you get a award-like notification.\nThere is also a xpgate block which, when placed under a wooden door will only allow players with a certain xp level to go through.\n\n* Forum-Topic: \u003chttps://forum.minetest.net/viewtopic.php?f=9\u0026t=20124\u003e\n* With some ideas from: \u003chttps://forum.minetest.net/viewtopic.php?id=3291\u003e\n\n## Installation\n\n- Unzip the archive, rename the folder to `xp_redo` and\nplace it in `.. minetest/mods/`\n\n- GNU/Linux: If you use a system-wide installation place\n    it in `~/.minetest/mods/`.\n\n- If you only want this to be used in a single world, place\n    the folder in `.. worldmods/` in your world directory.\n\nFor further information or help, see:  \nhttps://wiki.minetest.net/Installing_Mods\n\n## Privileges\n\n- **givexp**: Manage XP of your users.\n\n## Commands\n\nAdd or remove (amount with negative sign) XP from a user:\n\n```plaintext\n/givexp (username) (amount)\n```\n\nExamples:\\\nGive player somedude 200 XP points.\n\n```plaintext\n/givexp somedude 200\n```\n\nRemove 100 XP points from player somedude.\n\n```plaintext\n/givexp somedude -100\n```\n\n## Dependencies\n\n- `default` (included in [Minetest Game](https://github.com/minetest/minetest_game))\n\n### Optional dependencies\n\n- [`areas`](https://github.com/minetest-mods/areas)\n- [`qos`](https://github.com/S-S-X/qos)\n- [`protector`](https://notabug.org/TenPlus1/protector)\n- `doors` (included in [Minetest Game](https://github.com/minetest/minetest_game))\n- [`mobs_redo`](https://notabug.org/TenPlus1/mobs_redo)\n- [`mobs_animal`](https://notabug.org/TenPlus1/mobs_animal)\n- [`mobs_monster`](https://notabug.org/TenPlus1/mobs_monster)\n- [`mesecons_mvps`](https://github.com/minetest-mods/mesecons/tree/HEAD/mesecons_mvps)\n- [`hudbars`](https://codeberg.org/Wuzzy/minetest_hudbars)\n- `screwdriver` (included in [Minetest Game](https://github.com/minetest/minetest_game))\n- [`woodcutting`](https://github.com/minetest-mods/woodcutting)\n\n# Areas integration\n\nThere are additional commands available if the `areas` mod is available:\n\n* `/area_xp_set_min \u003cid\u003e \u003cxp\u003e` assign a min-value that a aplayer needs to interact with the area\n* `/area_xp_get_min \u003cid\u003e` returns the min-value, if any for that area\n\nFor this to work the area has to be opened with `/area_open \u003cid\u003e`\n\n# Builtin XP events\n\n## Digging\n\nEvery node dig gives you 1 xp point\n\n## Punching\n\nEvery mob punch gives you the amount of damage on the mob in xp\n\n## Ranks\n\nSee:\n\n- \u003chttps://github.com/mt-mods/xp_redo_ranks_ores\u003e\n\n## Settings\n\n* **xp_redo.discord.webhook_url** Discord webhook URL (optional)\n* **xp_redo.discord.texture_baseurl** Base URL for the webhook avatar image (optional)\n\nFor the webhook, the mod has to be in the `secure.http_mods` setting (in `minetest.conf`):\n\n```conf\nsecure.http_mods = xp_redo\n```\n\n## Lua api\n\n## Ranks\n\n### `xp_redo.register_rank(rankDef)`\n\n```lua\nrankDef = {\n\tname = \"Rank name\",\n\ticon = \"myicon.png\" -- Should fit withing the background icon (16x32px)\n\tcolor = {r=255, g=255, b=255}, -- Player name tag color\n\txp = 100 -- xp threshold\n}\n```\n\nRanks are held in `xp_redo.ranks` as a table.\n\n### `xp_redo.get_rank(xpAmount)`\n\nReturns the rankDef for given xp amount\n\n### Hooks\n\n```lua\nxp_redo.register_hook({\n  xp_change = function(playername, xp)\n    -- new xp value\n  end,\n\n  rank_change = function(playername, xp, rank)\n    -- new rank\n  end,\n\n  stat_change = function(playername, name, value)\n    -- see stats.lua\n  end\n})\n```\n\n## XP\n\n### `xp_redo.get_xp(playername)`\n\nReturns the XP level for given playername (always a number).\n\n### `xp_redo.add_xp(playername, xp)`\n\nAdds the amount of xp to given playername (can be negative for xp removal).\n\n# License\n\nSee LICENSE.txt\n\n- Trophy model/texture source: \u003chttps://gitlab.com/VanessaE/homedecor_modpack/\u003e\n- [`xp_mese_crystal.png`](https://github.com/minetest/minetest_game/blob/HEAD/mods/default/textures/default_mese_crystal.png)\n\n# Pull requests / bugs\n\nI'm happy for any bug reports or pull requests (code and textures).\n\n# TODO / Ideas\n\n* Scoreboard (block)\n* More doors\n* Door-teleport alternative\n* XP Regions\n* XP entities/items\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmt-mods%2Fxp_redo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmt-mods%2Fxp_redo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmt-mods%2Fxp_redo/lists"}