{"id":30384357,"url":"https://github.com/rapha149/voidtotem","last_synced_at":"2025-08-21T01:34:40.709Z","repository":{"id":51487633,"uuid":"443760441","full_name":"Rapha149/VoidTotem","owner":"Rapha149","description":"A Minecraft plugin that enables you to use a totem to save you from the void.","archived":false,"fork":false,"pushed_at":"2025-07-30T10:37:13.000Z","size":258,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-30T12:55:17.874Z","etag":null,"topics":["bukkit-plugin","minecraft","minecraft-plugin","spigot","spigot-plugin","totem","void"],"latest_commit_sha":null,"homepage":"https://www.spigotmc.org/resources/void-totem.99003/","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Rapha149.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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,"zenodo":null}},"created_at":"2022-01-02T12:28:36.000Z","updated_at":"2025-07-30T10:37:17.000Z","dependencies_parsed_at":"2023-01-25T21:45:34.511Z","dependency_job_id":"732b56e8-a069-48d2-91c2-b9a97830ace5","html_url":"https://github.com/Rapha149/VoidTotem","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Rapha149/VoidTotem","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rapha149%2FVoidTotem","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rapha149%2FVoidTotem/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rapha149%2FVoidTotem/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rapha149%2FVoidTotem/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Rapha149","download_url":"https://codeload.github.com/Rapha149/VoidTotem/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rapha149%2FVoidTotem/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271415284,"owners_count":24755629,"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","status":"online","status_checked_at":"2025-08-20T02:00:09.606Z","response_time":69,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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-plugin","minecraft","minecraft-plugin","spigot","spigot-plugin","totem","void"],"created_at":"2025-08-21T01:34:39.048Z","updated_at":"2025-08-21T01:34:40.700Z","avatar_url":"https://github.com/Rapha149.png","language":"Java","readme":"# VoidTotem\n\nA Minecraft plugin that enables you to use a totem to save you from the void.  \nYou can even set a custom item and recipe for the totem!\nIf you are resurrected by the totem you will be teleported onto a nearby block within a customizable search distance.\n\n## URLS\n\n- [Spigot](https://www.spigotmc.org/resources/void-totem.99003/)\n- [bStats](https://bstats.org/plugin/bukkit/Void%20Totem/13802)\n\n## Config\n\nThe default `config.yml` looks like this:\n```yml\n# VoidTotem version 2.0.5\n# Github: https://github.com/Rapha149/VoidTotem\n# Spigot: https://www.spigotmc.org/resources/void-totem.99003/\n\n# Whether to check for updates on enabling.\ncheckForUpdates: true\n\n# If the health of the player is be below or equal to this, the totem will try to resurrect the player.\n# It's expressed in half hearts, that means if it's 0 the player will be resurrected when he would have 0 hearts left,\n# if it's 10 the player will be resurrected when he would have 5 hearts left and if it's 20 the player will be resurrected on first void damage.\nhealthTrigger: 0.0\n\nsearch:\n  # Specifies the distance to search for suitable blocks. It's measured in blocks in every direction from the player.\n  distance: 100\n\n  # Customize the platform that will be created when the player is saved from the void but the plugin can't find a suitable block in the range of the search distance.\n  # This does not work for mobs, even if \"onlySavePlayers\" is \"false\".\n  platform:\n    # Whether or not the platform should be created. If disabled and the plugin can't find any suitable blocks, the player won't be saved.\n    enabled: true\n\n    # The size of the platform. It's measured in blocks in every direction from the center of the platform.\n    # For example: \"0\" will create a single block platform, \"1\" will create a 3x3 platform and \"2\" will create a 5x5 platform.\n    size: 2\n\n    # The y coordinate the platform will be created at.\n    height: 70\n\n    # The block the platform will be created from.\n    block: minecraft:cobblestone\n\n    # Whether or not the platform should be breakable by the player.\n    # This should not be enabled when disappearing is disabled.\n    # Please note: a platform that was unbreakable will be breakable after a restart/reload of the server.\n    breakable: false\n\n    # Customize the options for disappearing.\n    disappear:\n      # Whether or not the platform should disappear.\n      # Please note: if the server restarts/reloads while the platform is still there, it won't disappear after the restart/reload.\n      enabled: true\n\n      # Whether or not the platform should only disappear after the player has left the platform.\n      waitForPlayer: true\n\n      # The time in seconds before the platform disappears.\n      # If \"waitForPlayer\" is \"true\", the countdown will be started once the player leaves the platform.\n      # If \"waitForPlayer\" is \"false\", the countdown will start directly after the creation of the platform.\n      delay: 10\n\n      # Whether or not to create a hologram above the platform that shows the remaining time before the platform disappears.\n      hologram: true\n\n      # Whether or not to play the block breaking sound.\n      sound: true\n\n# If disabled, the totem will save players from the /kill command.\n# This is due to the fact that the damage cause in the Spigot API is the same for the void and /kill.\n# If enabled the totem will only resurrect people if they are below the downward height limit.\npatchKillCommand: true\n\n# If disabled, mobs who can hold the totem will be saved from the void, too.\n# That is the same behavior as for normal totem resurrections.\n# Please note: the platform (see above) will not be created for mobs.\nonlySavePlayers: false\n\n# If enabled the plugin makes sure that the player gets teleported even if that is cancelled by other plugins.\n# This might not work 100% of the time.\nforceTeleport: false\n\nplayerData:\n  # If enabled, the used totem statistic will be increased for the player if saved from the void.\n  totemStatistic: true\n\n  advancement:\n    # If enabled, the player will receive the totem advancement upon resurrection if they did not have it before.\n    enabled: true\n\n    # The advancement to grant the player. The advancement has to exist on the server.\n    advancement: minecraft:adventure/totem_of_undying\n\n    # The criteria to set completed. Set to \"[]\" to complete the whole advancement.\n    criteria: []\n\nrandomization:\n  # Whether to randomize search for suitable blocks.\n  enabled: true\n\n  # How far to spread distance randomization.\n  # For example: if it's 10, 10 distances will be shuffled. The distances 0-9 will be shuffled,\n  # the distances 10-19 will be shuffled and so on.\n  # Set to 0 to disable distance shuffling.\n  # Set to 1 to shuffle all distances (that might teleport the player far away).\n  distanceStack: 10\n\n  # If disabled and there is a block directly above you, that block will be chosen.\n  # In other words: the distance 0 won't be shuffled.\n  randomizeZeroDistance: true\n\neffects:\n  # Whether to restore the food level and saturation after resurrection.\n  restoreFoodLevel: false\n\n  # Whether to remove existing potion effects after resurrection.\n  # This is normal totem behaviour.\n  removeExistingEffects: true\n\n  # Potion effects to apply after resurrection.\n  list:\n    - name: REGENERATION\n      duration: 45\n      amplifier: 1\n    - name: FIRE_RESISTANCE\n      duration: 40\n      amplifier: 0\n    - name: ABSORPTION\n      duration: 5\n      amplifier: 1\n\nanimation:\n  # Whether to display teleport particles after resurrection.\n  teleportParticles: true\n\n  # Whether to play a teleport sound and delay totem effects for a short amount of time.\n  teleportSound: false\n\n  # Whether to display the totem effects (animation, particles and sound).\n  totemEffects: true\n\nitem:\n  # If disabled, the totem does not has to be hold in the hand to work.\n  # It then can by anywhere in the inventory.\n  # If enabled, the totem has to be in the mainhand or the offhand, just like a normal totem.\n  hasToBeInHand: true\n\n  # Whether to use a custom item (and recipe) for the totem item.\n  # If you made a mistake with the custom item you will be notified in the console and the item won't work.\n  # Please note: if you've changed something for the recipe and reloaded the config you may have to rejoin for the changes to take effect.\n  # Please also note: if you change the resulting item, earlier crafted totems will still work.\n  customItem: false\n\n  # Whether to add a recipe for the custom totem item.\n  # Only used when \"customItem\" is enabled.\n  # If disabled the custom totem item can only be obtained using the command.\n  enableRecipe: true\n\n  # If enabled, and \"customRecipe\" is enabled, you won't be able to use the custom totems for normal totem resurrections.\n  # This also applies for totems that were given to players using the command\n  #  included in the plugin - even if the command was executed before \"customRecipe\" was enabled.\n  # Please note: even if \"onlySavePlayers\" is enabled, the custom totem still won't work for mobs.\n  noNormalResurrection: false\n\n  # The item to use as a totem item and the result of the recipe.\n  result:\n    item: totem_of_undying\n    count: 1\n\n    # The display name of the item.\n    # You can use \"\u0026\" and a color code to colorize the chat or use the adventure text syntax. A few examples:\n    #  - \u0026e\u0026lText = yellow and bold\n    #  - \u003cyellow\u003e\u003cbold\u003eText = yellow and bold\n    #  - \u003c#ff0000\u003eText = red hex color\n    #  - \u003crainbow\u003eText\u003c/rainbow\u003e = rainbow colors\n    #  - \u003cgradient:yellow:gold\u003eText\u003c/gradient\u003e = gradient from yellow to gold\n    #  - \u003cgradient:#ff0000:#ff6f00:#ffff00\u003eText\u003c/gradient\u003e = gradient from red over orange to yellow (with hex colors)\n    # The adventure syntax is described here: https://docs.adventure.kyori.net/minimessage#format\n    # Please note that hex colors, rainbows and gradients are NOT supported in 1.15 and lower.\n    # You should only use them in 1.16 and above. They will look very weird in 1.15 and lower.\n    # \n    # If given in the NBT string, the display name in the NBT string will override this.\n    # Set to \"null\" to disable.\n    name: '\u00266Void \u0026eTotem'\n\n    # The lore of the item as an array. Each array item is a line in the lore.\n    # You can use the same format as for \"name\".\n    # If given in the NBT string, the lore in the NBT string will override this.\n    # Set to \"[]\" to disable.\n    lore:\n      - '\u00267Save yourself from the void!'\n\n    # The NBT string to apply to the item.\n    # Set to \"{}\" to disable.\n    # If you want to include ' in your nbt string, you can escape them using ''\n    # \n    # Please note that the default value only works for 1.21+\n    # \n    # If you don't know how NBT works, see this tutorial: https://minecraft.fandom.com/wiki/Tutorials/Command_NBT_tags\n    #  or use a /give generator and copy everything from { to }. Give command generator examples:\n    #  - https://mcstacker.net (click on the \"/give\" button)\n    #  - https://www.gamergeeks.net/apps/minecraft/give-command-generator\n    nbt: '{\"enchantment_glint_override\": 1b}'\n\n  recipe:\n    # Whether the recipe should be a shaped recipe.\n    shaped: true\n\n    # The ingredients in case \"shaped\" is disabled.\n    # You have to provide at least 1 and at most 9 ingredients.\n    shapelessIngredients:\n      - totem_of_undying\n      - ender_pearl\n      - chorus_fruit\n\n    # The ingredients in case \"shaped\" is enabled.\n    # The shape may differ from the original 3x3. For example it can be 2x3, 3x2 or 2x2.\n    # You have to provide at least 1 and at most 3 rows and at least 1 and at most 3 ingredients per row.\n    shapedIngredients:\n      - chorus_fruit | diamond | chorus_fruit\n      - ender_pearl | totem_of_undying | ender_pearl\n      - chorus_fruit | diamond | chorus_fruit\n```\n\nIf you need any help regarding the config, don't hesitate to ask, I tried to explain it as clearly as possible.\n\n### Messages\n\nYou can change all messages in the `messages.yml` file!\n\n## Commands\n\nThe plugin has one basic command: `/voidtotem`  \nThe alias is `/vt`  \nSub commands are:\n- `/voidtotem reload` - Reloads the config.\n- `/voidtotem giveitem [Player]` - Gives you or another player a void totem item. When using via the console the player has to be specified.  \n  If `customRecipe` was disabled on command execution, the item that was given to the player will also work when `customRecipe` is enabled.\n\n## Permissions\n\n- `voidtotem.reload` - Permission for `/voidtotem reload`\n- `voidtotem.giveitem` - Permission for `/voidtotem giveitem`\n- `voidtotem.giveitem.others` - Permission for `/voidtotem giveitem \u003cPlayer\u003e`\n\n## Additional information\n\nThis plugin collects anonymous server stats with [bStats](https://bstats.org), an open-source statistics service for Minecraft software. If you don't want this, you can deactivate it in `plugins/bStats/config.yml`.\n\n## Credits\n\nCredits go to [laGameTV](https://lagametv.de/) for the idea of the plugin.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frapha149%2Fvoidtotem","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frapha149%2Fvoidtotem","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frapha149%2Fvoidtotem/lists"}