JVillage: Difference between revisions

Latest revision as of 23:11, 13 August 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: @@
 [[Category:Server internals]]
-<q>''Death to Towny, rise up JVillage (SoonTM)'''</q><br />
+{{q|''Death to Towny, rise up JVillage (SoonTM)''|{{user|JohnyMuffin}} on December 11th, 2022}}
-{{user|JohnyMuffin}} on December 11th, 2022<br />
+<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 [https://j-stats.xyz/player?u=2cfc6452-a6b4-4c49-982e-492eaa3a14ec JohnyMuffin], exclusive to [[RetroMC (server)|RetroMC]].<br />
+'''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]
-== Differences betweeen JVillage and Towny ==
+== 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.
-:- '''No refunds will be issued upon unclaiming chunks or deleting a town.'''
+:- 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 time
+* 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 ==
-== 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.
-During that time period:
+* 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
 * 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>)]]
@@ Line 35: / Line 44: @@
 * <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
@@ Line 52: / Line 67: @@
 === Village flags ===
 [[File:JVillage-5.png|thumb|right|Flags.]]
-These are settings for your village.<br />
+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 23:11, 13 August 2024

Contents

Features

Differences between and migration from Towny