View source for JVillage

== Overview ==
BetaMC uses a fork of [https://wiki.retromc.org/JVillage '''JVillage'''] as the plugin that allows player to create, join, and manage villages, or as many say, towns.

JVillage was created by '''JohnyMuffin''' in 2023 as a replacement for Towny, a plugin with the same overall purpose as JVillage. Notably, JVillage lets players join multiple towns, the maximum being ''20'' on BetaMC.

== Villages ==
'''Villages''' are made up of its chunk-claims, its owner, and any members and/or assistants.

The '''owner''' has absolute power over the village, being able to edit flags, invite/kick/promote/demote players, and so forth. '''Assistants''' can claim land, and if permitted by the village flag ''ASSISTANT_CAN_WITHDRAW'', can withdraw from the village balance. '''Members''' can build and use things like doors, and if permitted by the village flag ''MEMBERS_CAN_INVITE'', can invite new members into the village. '''Randoms''', those who are not in the village, cannot build or use things like doors unless permitted by the flag ''RANDOM_CAN_ALTER''.

=== Land Claiming ===
The territory of a village is the chunks claimed for it by the owner and any assistants via '''/v claim''', each of which costing $25. The first chunk claimed is the one the owner is standing in upon creating the village via '''/v create <name>''', which costs $250.

Normally, a chunk must border a claimed chunk for the claiming to work; however, an outpost can be created with '''/v claim outpost''' for $125, claiming a chunk away from the others.
=== Managing Players ===
Owners and assistants can invite new members using '''/v invite <player-name>'''. If one is invited into a village, they can use '''/v join <village-name>''' to actually join the village.

If an owner wants to promote or demote someone, they can use '''/v promote/demote <player-name>''' to promote a member to assistant, or demote an assistant to member. If they wanted to remove a player from a village, they could use '''/v kick <player-name>'''.

The sum of the village members, assistant(s), and owner determine the village rank.
=== Village Ranks ===
{|class="wikitable" style="text-align:center"
|-
! Rank !! Owner Title !! Player Requirement
|-
| Tribe || Chief || 1
|-
| Settlement || Leader || 11
|-
| Town || rowspan=5|Mayor || 21
|-
| City || 51
|-
| Metropolis || 101
|-
| Megacity || 501
|-
| Ecumenopolis || 1001
|}
Currently, ranks do not do anything functional; they're just for show and bragging rights.
=== Flags ===
Village flags, viewable with '''/v flag list''', are like the rules or settings for the village. They are as follows:
*'''RANDOM_CAN_ALTER'''
**Determines whether outsiders can build in the village.
*'''MOBS_CAN_SPAWN'''
**Determines whether mobs can spawn within the village.
*'''MEMBERS_CAN_INVITE'''
**Determines whether regular members can invite more players.
*'''MOB_SPAWNER_BYPASS'''
**Determines whether mob spawners bypass ''MOBS_CAN_SPAWN''
*'''ASSISTANT_CAN_WITHDRAW'''
**Determines whether assistants can withdraw from the village balance
*'''PVP_ENABLED'''
**Determines whether players can attack each other within the village.
By default, they are all false. Owners can use '''/v flag <flag> <true/false>''' to change them.