Skip to content
This repository was archived by the owner on Oct 31, 2024. It is now read-only.

Gameplay

Austin Pilz edited this page Mar 16, 2017 · 6 revisions

This document is an overview of the various components and their functions within the Alcatraz game

Components

Objects

Prisons

Alcatraz is a prison management and simulation plugin, meaning it can handle multiple prisons each with their own simulation. Prison's are the "arenas" of Alcatraz, providing the environment in which inmates live and play. Every prison is separate with Alcatraz, allowing for different unique prison experiences all on the same server. Since Alcatraz works with Multiverse, you can even place prisons across multiple worlds.

Cells

Prisons have cells which house one inmate. The number of vacant cells within prison indicates the number of players that can join that prison. When all cells become occupied or if there are no cells, players will be unable to join that prison.

Chests

Prison's can have any of three following chest types:

  • Food Chest - Automatically regenerated chests with food for inmates to ensure they don't starve
  • Random Chest - Automatically regenerated chests that are filled with random items which can be used for combat or crafting
  • Reward Chest - Automatically regenerated chests that are filled with highly sought after items, such as shanks, lock picks and poisons.

All of these chests are automatically refilled randomly throughout time so long as there's at least one inmate playing within the prison. These chests must be placed and then added via command in order to associate them with Alcatraz. To find out more about how to add these chests to your game of Alcatraz, which is highly recommended, see the [Chest Setup Guide] (https://github.com/austinpilz/Alcatraz/wiki/Setup-Guide#chests)

Warden AI

The warden role of any Alcatraz prison is handled automatically by the plugin AI. The warden will periodically watch over all inmates, their belongings and their activities. In conjunction with Alcatraz Action Signs, the warden will hand out strikes in the event that an inmate is caught in the middle of prohibited behavior or in possession of contraband.

Inmate Statistics

There are 6 number of statistics that govern an inmates game within their prison session:

Time In

The number of minutes an inmate has been playing Alcatraz. This statistic is used to determine leader board status and inmate rank.

Time Left

A timer that displays the number of minutes left before the inmate is executed. Inmates are able to purchase additional minutes, prolonging their execution. You can find more about execution in the Execution section below.

To view the cost of each additional minute as an inmate, execute the command /alc cost

To purchase additional minutes as an inmate, execute the command /alc buy minute # where # is the number of minutes you'd like to purchase.

Strikes

Strikes can be accumulated by inmates for a variety of reasons (ie looting, having contraband). Strikes are awarded automatically by the AI warden. Players begin their game with 0 strikes. If an inmate accumulates 2 strikes, they are warned of their execution upon receiving 3. In the event that inmates would like to prolong their execution, they can purchase strike removals whose cost is dependent upon how many strikes an inmate currently has.

To view the cost of a strike removal as an inmate, execute the command /alc cost

To purchase a strike removal as an inmate, execute the command /alc buy strike# where # is the number of strikes you'd like to erase. You can have a minimum of zero strikes, you cannot have a negative strike balance.

Kills

The number of kills an inmate accumulates is directly associated with the number of other inmates the player kills. There is no maximum number of kills than an inmate can accumulate.

Money

Inmates are given a configured amount of starting money (typically $500) when beginning a new game in Alcatraz to be used for spending. Currently, funds can be used to purchase items from the prison commissary shop (coming in v1.6), additional minutes unit execution and to remove a strike.

If players have an economy balance (Alcatraz uses Vault) prior to joining a game, their entire balance will be deposited into their prison account to be used for spending. Likewise, if players have a prison balance greater than the configured starting value, that amount will be returned and deposited into the player's economy account upon leaving the game. This means that players can perform jobs within Alcatraz in order to raise funds that can be used outside of Alcatraz.

Rank

Coming soon!

Execution

Unique to Alcatraz, an objective of the clock ticking down to execution encourages players to make the most of their time in prison, prolonging execution for as long as possible. When players first begin their game, they're given a configured amount of minutes remaining before execution. As the minutes pass while the player is online, minutes are deducted from the inmate's "time left" timer. In efforts to encourage interaction between inmates and jobs, inmates have the ability to purchase additional minutes to prolong their execution. As their timer gets closer to 0, the more expensive remaining minutes become. When the timer reached 5 minutes, inmates are reminded to do something else face execution.Players can also be executed for accumulating too many strikes in game. When either their time left timer hits 0 or their strikes counter hits 3, players are "executed" and ejected from their game in Alcatraz. Players are then free to play Minecraft normally or can join another game of Alcatraz, but must start completely over.

Displays

Scoreboard

Upon beginning a game in Alcatraz or logging back in to resume one, all inmates are displayed a scoreboard with their inmate statistics on the right hand side of their screen. Their rank, time in, time left until execution, kills, strikes and money are all displayed on their screen at all times. The scoreboards are automatically updated.

Cell Signs

Cell signs are linked to a cell within a prison, displaying the associated prison, cell number and occupancy status. If a cell is vacant, the sign will display "Vacant". If the cell is occupied, the sign will display the resident inmate and their online/offline status.

Multiple cell signs can be associated with a cell. It's recommended that there is one cell sign outside and inside of the cell in order to avoid confusion. Additionally, you can create a wall with cell signs that enables players to see which other inmates are playing and which cell is theirs.

To remove a cell sign, simply break the sign and Alcatraz will remove it from the prison.

Leader Board

Coming soon!

Special Functions

Lock Picking

An inmate favorite function of Alcatraz is lock picking. To ensure maximum security, it's recommended that you use iron doors within your prisons. If an inmate clicks on an iron door, Alcatraz will see if the inmate has a valid lock pick (a prismarine shard, which can be crafted from prison items) in their inventory. If a lock pick is present, the inmate will attempt to pick the lock with a random chance of success. If the lock pick is successful, the pick will be removed from the inmates inventory and the door will silently open for 3 seconds before closing again.

Action Signs

Action signs are clickable signs placed throughout prisons which enable inmates to perform specialized actions. These signs are typically well hidden or hard to reach due to their powerful nature.

Loot Signs, when clicked, which attempt to randomly select another inmate to loot. If successful, the inventory of the looted inmate will appear on screen for the looter to access. If the loot fails, the looter can receive strikes automatically from the AI warden.

Raid Signs, when clicked, will teleport all inmates back to the prison spawn and search through all inventories for contraband. If items such as shanks or lock picks are found, they will be removed and strikes will be given to the owner.

Join Signs

Join signs allow players to see how many prison inmates are online vs offline and to join the prison by simply clicking the sign! There is no limit to the number of join signs you can add to your prison.

The [Join Sign Setup Guide] (https://github.com/austinpilz/Alcatraz/wiki/Setup-Guide#join-signs) will instruct you on how to add join signs to your prisons.

Regenerative Mining

Mining is a popular activity within Alcatraz, allowing inmates to mine from a list of approved materials. After the configured numbers of blocks have been broken within the prison, Alcatraz will automatically begin to regenerate the broken blocks a few ticks apart. This ensures that there's never any manual regeneration required.

In a coming update, inmates will be able to sell these items through the built in Alcatraz shop GUI. In the mean time, it's recommended that you setup buy/sell signs using your economy or other plugin which allows inmates to sell mined goods for money. This money will be deposited into their economy account, which is then automatically routed into their prison funds.

Blocks than can be broken by inmates within Alcatraz include:

Dirt
Cobblestone
Leaves
Stone
Diamond Ore
Gold Ore
Emerland Ore
Coal Ore
Lapis Ore
Redstone Ore
Obsidian
Iron Ore

In the event of a reload, Alcatraz will immediately regenerate all of the broken blocks at once. If your server crashes, Alcatraz will make every attempt to regenerate the broken blocks, but there is no guarantee that it will be permitted or able to do so.

Overriding Inmate Statistics

An inmate's statistics (kills, money, time in, time left, strikes) are all able to be overridden by any user that has the Alcatraz admin permission.

To override an inmate's statistics, execute the command /alca set [playerName] [kills/timein/timeleft/strikes/money] [value] where you replace [playerName] with the inmate's name, [kills/timein/timeleft/strikes/money] with one of the available options (without []'s) and [value] with the numerical value you'd like to update the statistic to

Note: You can override an inmate's strikes to be greater than the execution threshold and the time left to be 0. In these cases, the inmate will be immediately executed when the next automatic cycle checks for these values.

Error Handling

In the event that an object like chest or sign is broken without Alcatraz being properly notified, the object will be automatically dissociated upon the next server reload / restart. Additionally, you can force Alcatraz to reload itself by executing the command /alca reload which will verify the status of all signs and chests associated to prisons within Alcatraz.

Clone this wiki locally