JVillage: Difference between revisions

Latest revision as of 11:11, 28 September 2024

"Death to Towny, rise up JVillage (SoonTM)"

— JohnyMuffin on December 11th, 2022

Messages upon entering/exiting a village.

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

Village members list. (/v list)

List of villages the player in the image is currently in.

/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 in
mobs_can_spawn - Any & all mobs can spawn
random_can_alter - Non-members can modify blocks
mob_spawner_bypass - Bypasss the mobs_can_spawn flag so monster spawners can summon mobs
members_can_invite - Members (non-assistants) can invite other players to a village

@@ Line 1: / Line 1: @@
-<q>''Death to Towny, rise up JVillage (SoonTM)'''</q><br />
+[[Category:Server internals]][[Category:Plugins]]
--[https://j-stats.xyz/player?u=2cfc6452-a6b4-4c49-982e-492eaa3a14ec JohnyMuffin] on December 11th, 2022<br />
+{{q|''Death to Towny, rise up JVillage (SoonTM)''|{{user|JohnyMuffin}} on December 11th, 2022}}
+<hr>
+[[File:JVillage-1.png|thumb|right|Main menu.]]
+[[File:JVillage-6.png|thumb|right|Messages upon entering/exiting a village.]]
+'''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.
+* [[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]
+== Features ==
+* Players can own, assist, and be a member of multiple towns.
+* 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.
+* Outpost claims cost <span style="color:#55FF55;">$500</span> each.
-'''JVillage''' is a land claim management plugin made by [https://j-stats.xyz/player?u=2cfc6452-a6b4-4c49-982e-492eaa3a14ec JohnyMuffin], exclusive to [[RetroMC (server)|RetroMC]].<br />
+== Differences between and migration from Towny ==
-It aims to be a replacement for Towny, another land claim management plugin.
+* 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.
-== Differences betweeen JVillage and Towny ==
+* Nations, town plots, town & nation chats don't exist.
-* Players can own, assist, and be a member of multiple towns
+* Town suffixes (such as <code>[Hamlet]</code>) don't exist.
-* Towns intially cost $1000 to create
+<hr>
-:-No refunds will be issued at this time
+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
+:- 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 ==
+<code>/v</code> is used in place of <code>/village</code> for brevity.<br />
+See <code>/v help</code> for the full commands list.
+<br />
+Use <code>/v deposit <village> <amount></code> to give a specified village a specified money amount.<br />
+Each chunk claim costs <span style="color:#55FF55;">$10</span> and <span style="color:#55FF55;">$500</span> for outposts.<br />
+<code>/v claim</code> to claim and <code>/v claim outpost</code> to claim as outpost.
+=== Player commands ===
+[[File:JVillage-2.png|thumb|right|Village information. (<code>/v info</code>)]]
+[[File:JVillage-3.png|thumb|right|Village members list. (<code>/v list</code>)]]
+[[File:JVillage-7.png|thumb|right|List of villages the player in the image is currently in.]]
+[[File:JVillage-4.png|thumb|right|Commands list.]]
+* <code>/v info <village></code> - Shows village info
+* <code>/v list <village></code> - Shows village members
+* <code>/resident <username></code> or <code>/res <username></code> or <code>/player <username></code> - Shows the villages a specified player is currently in
+* <code>/v join [village]</code> - Joins a village (village assistants or owner needs to invite)
+* <code>/v leave [village]</code> - Leaves a village
+* <code>/v autoswitch [on/off]</code> - Autoswitch the selected town to another one upon entering its territory
+* <code>/v balance</code> - Shows a specified village's balance
+* <code>/v deposit <village> <amount></code> - Deposit a specified amount to a specified village
+* <code>/v spawn</code> - Teleport to village spawn
+=== Village assistant commands ===
+* <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
+* <code>/v unclaim</code> - Unclaims the chunk the you are currently on
+* <code>/v withdraw <village> <amount></code> - Withdraw a specified amount of money from a specified village
+* <code>/v invite [username]</code> - Invites the selected player to your town
+* <code>/v kick [username]</code> - Kicks the selected player from your town
+=== Village owner only ===
+* <code>/v create [name]</code> - Create a new village
+:- Costs <span style="color:#55FF55;">$1000</span> per village.
+* <code>/v setowner [username]</code> - Promote a village member to owner
+* <code>/v promote [username]</code> - Promote a member to assistant
+* <code>/v demote [username]</code> - Demote a member from assistant
+* <code>/v setspawn</code> - Set the spawn point for your village
+* <code>/v rename [name]</code> - Rename your village
+=== Village flags ===
+[[File:JVillage-5.png|thumb|right|Flags.]]
+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</code> = <code>/v flag</code>
+* <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>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>members_can_invite</code> - Members (non-assistants) can invite other players to a village

JVillage: Difference between revisions

Latest revision as of 11:11, 28 September 2024

Contents

Features

Differences between and migration from Towny