JVillage: Difference between revisions
Jump to navigation
Jump to search
Noggisoggi (talk | contribs) (Added the withdraw command and added a bit more info to the usage section.) |
Noggisoggi (talk | contribs) (Added to plugins category) |
||
| (11 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
[[Category:Server internals]] | [[Category:Server internals]][[Category:Plugins]] | ||
{{q|''Death to Towny, rise up JVillage (SoonTM)''|{{user|JohnyMuffin}} on December 11th, 2022}} | |||
{{user|JohnyMuffin}} on December 11th, 2022< | <hr> | ||
[[File:JVillage-1.png|thumb|right|Main menu.]] | [[File:JVillage-1.png|thumb|right|Main menu.]] | ||
[[File:JVillage-6.png|thumb|right|Messages upon entering/exiting a village.]] | [[File:JVillage-6.png|thumb|right|Messages upon entering/exiting a village.]] | ||
'''JVillage''' is a land claim management plugin made by | '''JVillage''' is a land claim management plugin made by {{User|JohnyMuffin}}, exclusive to [[RetroMC (server)|RetroMC]].<br /> | ||
It aims to be a replacement for Towny, another land claim management plugin. | It aims to be a replacement for Towny, another land claim management plugin. | ||
* [[JVillage/Admin commands]] exists for server staff and owners who use it. | |||
* '''Source code on GitHub''': [https://github.com/retromcorg/JVillage https://github.com/retromcorg/JVillage] | * '''Source code on GitHub''': [https://github.com/retromcorg/JVillage https://github.com/retromcorg/JVillage] | ||
== | == Features == | ||
* Players can own, assist, and be a member of multiple towns | * Players can own, assist, and be a member of multiple towns. | ||
* Towns intially cost <span style="color:#55FF55;">$1000</span> to create | * Towns intially cost <span style="color:#55FF55;">$1000</span> to create. | ||
:- | :- Refunds will be issued upon unclaiming chunks or deleting a town. | ||
{{Warning|Deleting a village with more than 2 claims will give only {{MCColor|&a|$}}1000 back, and ''not'' the total price of its additional claims.<br>Therefore, unclaiming every chunk in the village and ''then'' deleting will prevent losses related to this.}} | |||
* Land claims cost <span style="color:#55FF55;">$10</span> per chunk. | * Land claims cost <span style="color:#55FF55;">$10</span> per chunk. | ||
* Outpost claims cost <span style="color:#55FF55;">$500</span> each | * Outpost claims cost <span style="color:#55FF55;">$500</span> each. | ||
* Nations, town plots, town & nation chats don't exist | |||
* Town suffixes (such as <code>[Hamlet]</code>) don't exist | == Differences between and migration from Towny == | ||
* Players have to run <code>/v join <village></code> if they want to join one and are invited by a village's assistant or owner. | |||
The migration from Towny to JVillage happened between December 25 2022 to January 1 2023 | * Nations, town plots, town & nation chats don't exist. | ||
* Town suffixes (such as <code>[Hamlet]</code>) don't exist. | |||
<hr> | |||
The migration from Towny to JVillage happened between December 25 2022 to January 1 2023, and during that time period: | |||
* Towny data was migrated with some caveats | * Towny data was migrated with some caveats | ||
* Players who have didn't connect to [[RetroMC_(server)|RetroMC]] for an extended period of time didn't have their towns migrated | * Players who have didn't connect to [[RetroMC_(server)|RetroMC]] for an extended period of time didn't have their towns migrated | ||
:- These towns were transferred to a placeholder account until the owner or a member requests the town's ownership via a ticket on the [https://discord.retromc.org Discord server]. | :- These towns were transferred to a placeholder account until the owner or a member requests the town's ownership via a ticket on the [https://discord.retromc.org Discord server]. | ||
* Claims that were created before a certain date cannot be refunded. | |||
== Usage == | == Usage == | ||
<code>/v</code> is used in place of <code>/village</code> for brevity.<br /> | <code>/v</code> is used in place of <code>/village</code> for brevity.<br /> | ||
| Line 44: | Line 49: | ||
=== Village assistant commands === | === Village assistant commands === | ||
* <code>/v claim</code> - Claims the chunk the you are currently on | * <code>/v claim</code> - Claims the chunk the you are currently on | ||
* <code>/v claim ac</code> - Toggles auto-claiming which will claim chunks as you walk | |||
* <code>/v claim rect [chunk radius]</code> - Claim a rectangular radius of chunks around your current location | |||
:- Costs <span style="color:#55FF55;">$10</span> per chunk | :- Costs <span style="color:#55FF55;">$10</span> per chunk | ||
* <code>/v unclaim</code> - Unclaims the chunk the you are currently on | * <code>/v unclaim</code> - Unclaims the chunk the you are currently on | ||
| Line 49: | Line 56: | ||
* <code>/v invite [username]</code> - Invites the selected player to your town | * <code>/v invite [username]</code> - Invites the selected player to your town | ||
* <code>/v kick [username]</code> - Kicks the selected player from your town | * <code>/v kick [username]</code> - Kicks the selected player from your town | ||
=== Village owner only === | === Village owner only === | ||
* <code>/v create [name]</code> - Create a new village | * <code>/v create [name]</code> - Create a new village | ||
| Line 59: | Line 67: | ||
=== Village flags === | === Village flags === | ||
[[File:JVillage-5.png|thumb|right|Flags.]] | [[File:JVillage-5.png|thumb|right|Flags.]] | ||
These are settings for | These are settings for villages - only village owners can modify these.<br /> | ||
* <code>/v flags [flag] [true/false|on/off]</code> - Toggle a setting | * <code>/v flags [flag] [true/false|on/off]</code> - Toggle a setting | ||
:- <code>/v flags</code> = <code>/v flag</code> | :- <code>/v flags</code> = <code>/v flag</code> | ||
* <code>/v flag list</code> - List settings & their toggled status | * <code>/v flag list</code> - List settings & their toggled status | ||
---- | ---- | ||
* <code>assistant_can_withdraw</code> - Allow village assistants to withdraw money deposited into the village they're in | |||
* <code>mobs_can_spawn</code> - Any & all mobs can spawn | * <code>mobs_can_spawn</code> - Any & all mobs can spawn | ||
* <code>random_can_alter</code> - Non-members can modify blocks | * <code>random_can_alter</code> - Non-members can modify blocks | ||
* <code>mob_spawner_bypass</code> - Bypasss the <code>mobs_can_spawn</code> flag so monster spawners can summon mobs | * <code>mob_spawner_bypass</code> - Bypasss the <code>mobs_can_spawn</code> flag so monster spawners can summon mobs | ||
* <code>members_can_invite</code> - Members (non-assistants) can invite other players to a village | * <code>members_can_invite</code> - Members (non-assistants) can invite other players to a village | ||
Latest revision as of 11:11, 28 September 2024
"Death to Towny, rise up JVillage (SoonTM)"
—
JohnyMuffin on December 11th, 2022
JVillage is a land claim management plugin made by
JohnyMuffin, exclusive to RetroMC.
It aims to be a replacement for Towny, another land claim management plugin.
- JVillage/Admin commands exists for server staff and owners who use it.
- Source code on GitHub: https://github.com/retromcorg/JVillage
Features
- Players can own, assist, and be a member of multiple towns.
- Towns intially cost $1000 to create.
- - Refunds will be issued upon unclaiming chunks or deleting a town.
⚠️ Warning: Deleting a village with more than 2 claims will give only $1000 back, and not the total price of its additional claims.
Therefore, unclaiming every chunk in the village and then deleting will prevent losses related to this.
- Land claims cost $10 per chunk.
- Outpost claims cost $500 each.
Differences between and migration from Towny
- Players have to run
/v join <village>if they want to join one and are invited by a village's assistant or owner. - Nations, town plots, town & nation chats don't exist.
- Town suffixes (such as
[Hamlet]) don't exist.
The migration from Towny to JVillage happened between December 25 2022 to January 1 2023, and during that time period:
- Towny data was migrated with some caveats
- Players who have didn't connect to RetroMC for an extended period of time didn't have their towns migrated
- - These towns were transferred to a placeholder account until the owner or a member requests the town's ownership via a ticket on the Discord server.
- Claims that were created before a certain date cannot be refunded.
Usage
/v is used in place of /village for brevity.
See /v help for the full commands list.
Use /v deposit <village> <amount> to give a specified village a specified money amount.
Each chunk claim costs $10 and $500 for outposts.
/v claim to claim and /v claim outpost to claim as outpost.
Player commands
/v info)
/v list)
/v info <village>- Shows village info/v list <village>- Shows village members/resident <username>or/res <username>or/player <username>- Shows the villages a specified player is currently in/v join [village]- Joins a village (village assistants or owner needs to invite)/v leave [village]- Leaves a village/v autoswitch [on/off]- Autoswitch the selected town to another one upon entering its territory/v balance- Shows a specified village's balance/v deposit <village> <amount>- Deposit a specified amount to a specified village/v spawn- Teleport to village spawn
Village assistant commands
/v claim- Claims the chunk the you are currently on/v claim ac- Toggles auto-claiming which will claim chunks as you walk/v claim rect [chunk radius]- Claim a rectangular radius of chunks around your current location
- - Costs $10 per chunk
/v unclaim- Unclaims the chunk the you are currently on/v withdraw <village> <amount>- Withdraw a specified amount of money from a specified village/v invite [username]- Invites the selected player to your town/v kick [username]- Kicks the selected player from your town
Village owner only
/v create [name]- Create a new village
- - Costs $1000 per village.
/v setowner [username]- Promote a village member to owner/v promote [username]- Promote a member to assistant/v demote [username]- Demote a member from assistant/v setspawn- Set the spawn point for your village/v rename [name]- Rename your village
Village flags
These are settings for villages - only village owners can modify these.
/v flags [flag] [true/false|on/off]- Toggle a setting
- -
/v flags=/v flag
/v flag list- List settings & their toggled status
assistant_can_withdraw- Allow village assistants to withdraw money deposited into the village they're inmobs_can_spawn- Any & all mobs can spawnrandom_can_alter- Non-members can modify blocksmob_spawner_bypass- Bypasss themobs_can_spawnflag so monster spawners can summon mobsmembers_can_invite- Members (non-assistants) can invite other players to a village