JVillage: Difference between revisions
Jump to navigation
Jump to search
Noggisoggi (talk | contribs) m (Added assistant_can_withdraw) |
Noggisoggi (talk | contribs) mNo edit summary |
||
| (15 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 | [[File:JVillage-1.png|right|thumb|Main menu.]] | ||
[[File:JVillage-6.png|thumb | [[File:JVillage-6.png|right|thumb|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 | * Towns intially cost {{MCColor|&a|$}}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 {{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.<br>In addition, per-chunk claim refunds are only valid for 7 days from the initial claim; beyond that timeframe, claims can still be removed, but refunds won't be given.}} | |||
* | * Nations, which can be created at a cost of {{MCColor|&a|$}}50000 via <code>/nation create</code>, are a tier above towns and possess their own banks, warps and internal chat (<code>/n chat</code>). | ||
* For {{MCColor|&a|$}}10, 20 chunks can be claimed - the latter number increases by 20 with each town member - up to 50 people, resulting in 1000 chunks. | |||
** Going past that limit (be it 20 for 1-person village or 1000 for a 50-member one) will result in each chunk becoming more expensive to claim by {{MCColor|&a|$}}0.01, starting from {{MCColor|&a|$}}10, up to and including {{MCColor|&a|$}}50. | |||
== | * Titles are applied to villages based on member count. (''Settlement'' for 1 member, ''Village'' for 10 and so on till ''Megacity'' for >100) | ||
The migration from Towny to JVillage happened between December 25 2022 to January 1 2023 | * Outpost claims cost {{MCColor|&a|$}}500 each. | ||
* Towny data was migrated with some caveats | == 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. | |||
* Players have to pay in-game money to claim land. | |||
<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. | |||
* 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 couldn't 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 /> | ||
See <code>/v help</code> for the full | See <code>/v help</code> for the full command lists . | ||
<br /> | <br /> | ||
Use <code>/v deposit <village> <amount></code> to give a specified village a specified money amount.<br /> | Use <code>/v deposit <village> <amount></code> to give a specified village a specified money amount.<br /> | ||
| Line 44: | Line 51: | ||
=== 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 59: | Line 68: | ||
=== 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> | ||
| Line 65: | Line 74: | ||
---- | ---- | ||
* <code>assistant_can_withdraw</code> - Allow village assistants to withdraw money deposited into the village they're in | * <code>assistant_can_withdraw</code> - Allow village assistants to withdraw money deposited into the village they're in | ||
* <code>mobs_can_spawn</code> - | * <code>mobs_can_spawn</code> - Allow mobs to spawn | ||
* <code>random_can_alter</code> - | * <code>random_can_alter</code> - Allow non-members to 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> - | * <code>members_can_invite</code> - Allow members (non-assistants) to invite other players to a village | ||
* <code>prevent_mushroom_spread</code> - Disable mushrooms from spreading | |||
=== Nations === | |||
<gallery mode=nolines> | |||
File:JVillage-Nation-Commands.png|<code>/nation</code> | |||
</gallery> | |||
Latest revision as of 23:53, 18 April 2026
"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.
In addition, per-chunk claim refunds are only valid for 7 days from the initial claim; beyond that timeframe, claims can still be removed, but refunds won't be given.
- Nations, which can be created at a cost of $50000 via
/nation create, are a tier above towns and possess their own banks, warps and internal chat (/n chat). - For $10, 20 chunks can be claimed - the latter number increases by 20 with each town member - up to 50 people, resulting in 1000 chunks.
- Going past that limit (be it 20 for 1-person village or 1000 for a 50-member one) will result in each chunk becoming more expensive to claim by $0.01, starting from $10, up to and including $50.
- Titles are applied to villages based on member count. (Settlement for 1 member, Village for 10 and so on till Megacity for >100)
- 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. - Players have to pay in-game money to claim land.
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 couldn't be refunded.
Usage
/v is used in place of /village for brevity.
See /v help for the full command lists .
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- Allow mobs to spawnrandom_can_alter- Allow non-members to modify blocksmob_spawner_bypass- Bypasss themobs_can_spawnflag so monster spawners can summon mobsmembers_can_invite- Allow members (non-assistants) to invite other players to a villageprevent_mushroom_spread- Disable mushrooms from spreading
Nations
-
/nation
