Scarpet UHC is a cool little scarpet app that lets you play simple and fun UHCs with your friends. This app was not designed for big servers but as a simpler alternative to sometimes complex plugins, in an environment that allows modding and more.

Running this app will of course require you have carpet installed on your server, which you can download here, along with all of its installation instructions. This app is made for carpet version 1.4.29 and will not work for version below, or at least incorrectly. It should be fine for above version but if something breaks don't blame me.

To install the app just drag it into the scripts folder you the world that you want to use. The file should be at ...\world\scripts\scarpet_uhc.sc. If you plan to use the world generator app, add world_generator.sc in the same folder. If you are familiar with the carpet mod, none of this should be new.

This app saves itself quite often, and thus will keep settings and game state between restarts. Although it is never recommended to restart your server in the middle of a game, it should be fine. This is also true in case of a server crash (this it when it would be most useful). You should also note that in case of a restart of the app/server, the game will automatically pause.

Upon logging into your world with the app installed, you should be teleported to a hub. If this does not happen, make sure that the app is loaded with /script load scarpet_uhc . Use /scarpet_uhc to see the credits and the app version. At this point, the app is waiting for you to start the game, but before doing so you may want to edit the settings.

All the settings presented in this section can be modified 2 ways :

• Using the /scarpet_uhc settings change <category> <setting> <value> command
• By changing them directly in settings.json, and then updating them in game using /scarpet_uhc settings reload . This file will automatically be generated on the app's first start, but you can edit the settings beforehand by having settings.json already at ...\world\scripts\scarpet_uhc.data\settings.json.

You can see all of the settings at any time using /scarpet_uhc settings list [<category>] or simply reset them using /scarpet_uhc settings reset .

• Gamerules

In this category you will find all the gamerule related settings. These are here mostly to avoid you 10 minutes of typing commands in chat. There still are some special ones in the middle.

• Timers

Do I really have to explain what the category is for ? Note that all timers are in ticks, where 1 second = 20 ticks, do some quick math to obtain the durations you want.

Setting a timer to 0 will make it execute on start, and to -1 will disable it completely.

• Border

Here you have all of the border size and speed settings. Note that sizes are a radius, so a radius of 750 would mean that players are free from 750x, 750z, to -750x, -750z.

• Teams

• Other

(*)This fake player can be disconnected with /kill, if you want to actually kill the player, use /effect give <player> instant_damage 99 99

In this app all the team’s management is done through the /scarpet_uhc team command. There is a total of 16 teams available, and there currently is no way to customize team names. The 16 teams are the default Minecraft teams color. The app will self-adjust depending on the number of teams. A team is considered as existing as soon as there is a player inside.

With this command you can add players to a team, amazing !

Make players leave teams with this one. Note that since you can select multiple entities, using /scarpet_uhc team leave @a will make everyone leave their team.

Empties a team, quite self-explaining.

This command randomizes teams. You can choose the size you want for your teams by setting a <teamSize> (int) parameter. By setting <force> (boolean, true by default), you can choose if players that are already in a team will be dispatched in new teams (true), or if only players that are spectators will go into random teams (false).

If for some reason players are not happy with the color of their team, this command lets you swap the colors of two teams. Team compositions will stay the same, this is just for aesthetic purposes.

If you want your players to choose their teams by themselves, you can place wool blocks in the hub. Clicking on a wool block will make you join the team of the same color as the block. Players can leave their team by clicking on a dark/gray/light gray stained glass block. This command will replace glass blocks with wool and wool with glass blocks for the teams specified in <teams>. <teams> can be all to swap every block or a list a team names seperated by spaces (i.e. 'blue red dark_aqua').

If turned on in the settings, teams will be disabled. Every player will be in its own team. Turn on to experience true battle royale. Wool blocks still work : clicking any color will make you a player, and (light) gray/black stained glass will make you spectate. Unlike in team mode, everyone is a player by default.

Now that you have nicely setup your game, you can start it for good. To do so, simply use /scarpet_uhc game start . At this point all players will be teleported with their teams across the map and spectators will be put in spectator mode.

Here are a few commands that you can use while in game :

This command will pause/unpause the game. When the game is paused, players are in spectator and cannot move, time stops, and the world border stops moving.

Prematurely triggers an event. Events can only be triggered once, full list of events here.

Teleports a player to the surface. If the player is in the nether, a portal will be placed at their position. Useful if you have players stuck in the nether or hiding at the end of the game.

Heals players amount half-hearts (20 by default). Note that you can also damage players with this command by healing a negative amount of HP.

Revives a player that died (the player must be online). You can revive the player with amount HP (10 by default). If no surfacelocation is specified, the player will respawn at the position of one of his teammates, and if none is alive and/or online, the default position is 0 0. surfacelocation does not take a y component, the y level is determined by the terrain.

During gameplay, a bossbar will appear at the top of your screen with all kind of cool info. You will find the day you are on (1 day = 20 minutes), the number of players and teams left, as well as the border size. The time in the current day is shown in the form of the bar filling up, with one notch corresponding to 1 minute.

I may make it so that this bossbar is customizable later.

Events will occur at the time that you set. All the events are signalled in chat and with some kind of sound effect. You will also get a reminder of when they will happen at the start of the game, 10 minutes before the event and 30 seconds before the event.

When a player disconnects during the game and if the settings ghost_players is set to true, players will be replaced with a ghost version of themself (aka carpet player shadow). This fake player will still be able to be killed and drop its stuff.

The game will end once there is only one team left. Players disconnecting should not end the game. Note : if the game was started with only one team, the game will end once there is only one player left.

This should probably be on its own on another page, but it is now too late to go back (not really but I'm lazy).

If you want to avoid lag during your game, you can use Alt-F4 the world_generator app that is given for free with the scarpet_uhc app. In this section I will quickly go over how it works.

If you are too lazy to read the following section, you can simply type /scarpet_uhc generate_world, and then click on the command provided in chat to pregenerate your world. The command given will generate both overworld and nether and will fill your border.

If you want to be the big boy that decides everything on its own and uses commands with the settings that he wants, this section is for you.

This command will start a new world generation task. Tasks can be paused and cancelled and will keep running after a server restart. You can follow the app's progress in your server's console or with /world_generator info.

If chunkPerSec is set to 20, you can speed up the generation by using the carpet command /tick warp <ticks>, where ticks is the number of steps returned by /world_generator start. This will also work with chunkPerSec other than 20 but works best with the default settings.

Cancels or pauses current generation task. Note that cancelled tasks cannot be restarted, and you will have to start over if you want to generate the same area. Paused tasks can be resumed with the same command.