JVillage: Difference between revisions

From RetroMC
Jump to navigation Jump to search
m (Minor formatting changes in quote)
mNo edit summary
 
(9 intermediate revisions by the same user not shown)
Line 1: Line 1:
[[Category:Server internals]]
[[Category:Server internals]][[Category:Plugins]]
''<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>
<hr>
[[File:JVillage-1.png|thumb|right|Main menu.]]
[[File:JVillage-1.png|right|thumb|Main menu.]]
[[File:JVillage-6.png|thumb|right|Messages upon entering/exiting a village.]]
[[File:JVillage-6.png|right|thumb|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.
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.
* [[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]
== 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 {{MCColor|&a|$}}1000 to create.
:- Refunds will be issued upon unclaiming chunks or deleting a town, '''but those claims that were created before a certain date cannot be refunded'''.
:- Refunds will be issued upon unclaiming chunks or deleting a town.
* Land claims cost <span style="color:#55FF55;">$10</span> per chunk.
{{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.}}
* Outpost claims cost <span style="color:#55FF55;">$500</span> each time
* 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>).
* Nations, town plots, town & nation chats don't exist
* 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.
* Town suffixes (such as <code>[Hamlet]</code>) don't exist
** 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.
== Migration from Towny ==
* 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.
During that time period:
 
* 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 commands list.
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 53: Line 58:
* <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 70: 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> - Any & all mobs can spawn
* <code>mobs_can_spawn</code> - Allow mobs to spawn
* <code>random_can_alter</code> - Non-members can modify blocks
* <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> - Members (non-assistants) can invite other players to a village
* <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)"

16.png JohnyMuffin on December 11th, 2022


Main menu.
Messages upon entering/exiting a village.

JVillage is a land claim management plugin made by 16.png JohnyMuffin, exclusive to RetroMC.
It aims to be a replacement for Towny, another land claim management plugin.

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

Village information. (/v info)
Village members list. (/v list)
List of villages the player in the image is currently in.
Commands 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

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 - Allow mobs to spawn
  • random_can_alter - Allow non-members to modify blocks
  • mob_spawner_bypass - Bypasss the mobs_can_spawn flag so monster spawners can summon mobs
  • members_can_invite - Allow members (non-assistants) to invite other players to a village
  • prevent_mushroom_spread - Disable mushrooms from spreading

Nations