Server: Difference between revisions

From The Blockheads Wiki
>Thelastone
m (Thelastone moved page Server to Category talk:Wees: s)
No edit summary
 
(21 intermediate revisions by 7 users not shown)
Line 1: Line 1:
Whorgasm
{{outdated}}
[[File:Server Connect.png|thumb|right|250px|Server connection screen]]
A '''server''' is an online [[world]] that allows multiple players and devices to play together. Unlike other forms of [[multiplayer]], all players can freely connect, reconnect, and disconnect. A local network game is similar to a local server in that it could be used as a server if set up correctly. Starting in [[Game updates/20140402|version 1.5]], servers may also be 4x or 16x larger.
 
A link to a server can be shown in the following formats:
* <nowiki>blockheads://(server domain or IP):(port)</nowiki>
* <nowiki>http://theblockheads.net/join/(server domain or IP):(port)</nowiki>
* <nowiki>http://theblockheads.net/join.php?id=(cloud world ID)&name=(world name; URL-encoded)</nowiki>
 
==Nicknames==
Nicknames are names used to identify an account. An unlimited number of nicknames may be created by a device on a server, but only one can be running actions from a device at any given time.
 
When creating a nickname, the nickname chosen cannot have been banned or have been previously used. Nicknames are required to be unique in a world on Mac servers and unique in all cloud servers on the cloud. On Mac servers, nicknames can only be logged in to from the same device it was created with, or another device sharing the same iCloud, [[Game Center]], Google Play, or Amazon Game Circle account. On cloud servers, nicknames can only be logged into from a device sharing the support ID found at the bottom of the Help/Credits screen of the [[Pause Menu|pause menu]]. A nickname cannot be logged in to from multiple devices at the same time.
 
[[Blockhead]]s and their [[item]]s are tied to an an account. Blockheads cannot be moved or transferred between nicknames.
 
[[Shop]]s can only be stocked, have the price set, have the profit collected, and removed by the player who placed it.
 
[[Safe]]s, [[Display Cabinet|display cabinets]], and [[Portal Chest|portal chests]] cannot accessed or removed by other players. [[Iron Door|Iron doors]] and [[Iron Trapdoor|iron trapdoors]] cannot be passed through by other players, although they may be mined through if an [[Ownership Sign|ownership sign]] is not present.
 
[[Sign]]s, [[painting]]s, and [[column]]s cannot be removed by other players.
 
[[Chest]]s, [[Shelf|shelves]], [[ladder]]s, [[stairs]], [[Crafting Surface|crafting surfaces]], [[portal]]s, [[Trade Portal|trade portals]], [[Steam Locomotive|steam locomotives]], [[Rail Handcar|rail handcars]], [[Elevator Shaft|elevator shafts]], [[Electric Elevator Motor|electric elevator motors]], [[Wooden Bed|wooden beds]], [[Soft Bed|soft beds]], and [[Golden Bed|golden beds]] can be used by other players, but not removed.
 
In addition, each of the items above cannot be picked up if it doesn't belong to a player, except for direct player-to-player item exchanges.
 
However, Admins are able to remove, use, and modify anything a player has placed.
 
==Server Hosting==
===Cloud Server===
Added in [[Game updates/20140527|version 1.5.1]], cloud servers can be created with the app. [[In-App Purchase|In-app purchase]]s are used to add credit. [[World Credit]] is added by the owner upon creation of the world, while additional time can be bought with money by any player using the [[World Credit]] option in a portal or by adding credit in the [[Pause Menu]]. They can be managed online using the [[Owner Portal|owner portal]].
 
====Creating a Server====
# Scroll to "CREATE WORLD"
# Tap "ONLINE", then "CREATE WORLD..."
# Enter name, size, and nickname/avatar, then tap "CREATE WORLD..."
# Choose world difficulty (normal or expert mdoe), then tap "CREATE WORLD..."
# Choose world type (survival or custom rules), then tap "CREATE WORLD..."
# Choose privacy settings, initial world credit, then tap "CREATE WORLD..."
# Agree to conditions by tapping "OK"
 
===Mac Server App===
[[File:Mac Server App.png|thumb|right|Mac Server App]]
The [https://apps.apple.com/us/app/blockheadsserver/id662633568 Mac Server App] is free and allows worlds to be hosted. It can be connected to using Local Network, or, if set up correctly, by anyone, using port forwarding to forward the correct port to a Mac. Mac servers can have up to 32 players connected at once. It requires Mac OS X 10.8 Mountain Lion or higher to run.
 
====Creating a Server====
# Download the server app from the Mac App Store
# Open the app and click "New"
# Enter name of server
# Click "Start"
 
====Server Interface====
A chat log and a chat box are located on the right hand side. A player log with player nicknames and IPs is in the middle. Banning, kicking, and whitelisting can both be done from the chat box and the interface. Other server commands can be used through the chat box.
 
===Linux Server===
The [https://majicdave.com/share/blockheads_server171.tar.gz Linux Server] is free and allows worlds to be hosted. It can be connected to using Local Network, or, if set up correctly, by anyone, using port forwarding to forward the correct port to a Linux device. Linux servers can have up to 32 players connected at once.
 
===BlockServer===
[[File:BlockServer.png|thumb|right|BlockServer home page (November 2013)]]
[[File:BlockServer Server List.png|thumb|right|BlockServer's list of servers (November 2013)]]
Server hosting using [http://blockserver.net/ BlockServer] cost $0.20 USD per world per day. Each world had a public world page located at <nowiki>http://blockserver.net/world/</nowiki> followed by the world's name. BlockServer servers could have up to 16 players connected at once. BlockServer backed up servers every day, storing a backup for two months. On June 12, 2014, BlockServer closed, and new worlds could no longer be created and new credit could no longer be added. Credit can be transferred to the game or refunded. Worlds would remain on BlockServer until credit has been exhausted, and could be transferred to the cloud system at any time.
 
The BlockServer website now redirects to The Blockheads website. Functionality similar to that of BlockServer has been implemented through the [[Owner Portal|owner portal]] interface.
 
==Powers==
===Mods===
Mods may also ban players who have placed certain crafting surfaces. There is also the added kick and ban options when clicking on a player's icon.
 
 
Mods can use the following commands in the chat:
* /HELP
* /PLAYERS
* /KICK
* /BAN
* /BAN-NO-DEVICE
* /UNBAN
* /WHITELIST
* /UNWHITELIST
* /LIST-BLACKLIST
* /LIST-WHITELIST
* /DEBUG-LOG
 
===Admins===
Admins can use all commands in the chat except for /SET-PASSWORD, /REMOVE-PASSWORD, and /SET-PRIVACY. Admin can see all areas in the world that have been explored. They may also pass through others' [[Iron Door|iron doors]] and [[Iron Trapdoor|iron trapdoors]], and use and pick up all items, even those not owned by them. ([[Crafting Surface|crafting surfaces]], [[Wooden Bed|beds]], [[chest]]s, [[safe]]s, [[Shelf|shelves]], etc.)
 
===Owners===
Owners have the same powers as admins, with the additional ability of being able to set passwords and change privacy settings. Owners are by default set to the creator of a cloud server.
 
Owners of Mac Servers can be set using the /SET-OWNER command.
 
===Super Mods===
[[File:Supermod_milla.png|thumb|right|Super Mods are identified by a red background. ]]
Super Mods have absolute power on all cloud server worlds on The Blockheads. Super Mods are part of The Blockheads Team and have the ability to set or remove owners of a cloud server and do various tasks that only Super Mods can do.
 
Super Mods can not be Muted, Reported, Banned or Kicked as indicated in the thumb on the right.
 
Current Super Mods:
* Dave Frampton (majicDave)
* Camilla Koutsos (milla)
* NoodleCake (NoodleKing)
 
==Server Commands==
Server commands are done through the chat. Only admins and mods can use server commands. All commands are case-insensitive, for both the command itself and its input. Commands are not shown to the public, nor are their responses.
 
{| class="wikitable"
! scope="col" width="230px" | Command
! scope="col" | Powers required
! scope="col" | Server type
! scope="col" | Description
|-
| '''/HELP'''
| Mod or higher
| All
| Displays the in-game list of commands. Only displays commands available to the player who used it.
|-
| '''/PLAYERS'''
| Mod or higher
| All
| Lists all players on the server who aren't away or offline. The list is presented in this manner:
(player name) | (IP address) | (unique device identifier)
|-
| '''/KICK''' ''player_name''
| Mod or higher
| All
| Disconnects that player from the server. They can still reconnect.
|-
| '''/BAN''' ''player_name_or_ip''
| Mod or higher
| All
| Disconnects that player/IP from the server, and prevents anyone using that nickname, device, or IP from reconnecting.
|-
| '''/BAN-NO-DEVICE''' ''player_name_or_ip''
| Mod or higher
| All
| Disconnects that player/IP from the server, and prevents anyone using that same nickname/IP from reconnecting.
|-
| '''/UNBAN''' ''player_name_or_ip''
| Mod or higher
| All
| Removes player/IP from the blacklist, and allows them to reconnect. The identifier that was banned must be unbanned.
|-
| '''/WHITELIST''' ''player_name_or_ip''
| Mod or higher
| All
| Adds player/IP to the whitelist. If there was no whitelist previously, everyone else is disconnected.
|-
| '''/UNWHITELIST''' ''player_name_or_ip''
| Mod or higher
| All
| Disconnects that player/IP from the server, and removes them from the whitelist. The identifier that was whitelisted must be unwhitelisted.
|-
| '''/LIST-BLACKLIST'''
| Mod or higher
| All
| Lists the 50 most recently added players to the blacklist.
|-
| '''/LIST-WHITELIST'''
| Mod or higher
| All
| Lists the 50 most recently added players to the whitelist.
|-
| '''/DEBUG-LOG'''
| Mod or higher
| All
| Lists debug data.
|-
| '''/STOP'''
| Admin or higher
| All
| Turns off the server. If a cloud server or on BlockServer, instead restarts the server.
|-
| '''/LIST-MODLIST'''
| Admin or higher
| All
| Lists the 50 most recently added mods.
|-
| '''/LIST-ADMINLIST'''
| Admin or higher
| All
| Lists the 50 most recently added admins.
|-
| '''/PVP-ON'''
| Admin or higher
| All
| Enable PVP, allowing players to directly attack each other
|-
| '''/PVP-OFF'''
| Admin or higher
| All
| Disables PVP, preventing players from directly attacking each other
|-
| '''/LOAD-LISTS'''
| Admin or higher
| All
| Checks the whitelist, blacklist, modlist, and adminlist files for pending changes, and applies them.
|-
| '''/MOD''' ''player_name''
| Admin or higher
| All
| Gives that player moderator powers. If not previously whitelisted on a whitelisted server, whitelists them.
|-
| '''/UNMOD''' ''player_name''
| Admin or higher
| All
| Revokes that player's moderator powers. If not seperately whitelisted on a whitelisted server, unwhitelists them.
|-
| '''/ADMIN''' "player_name''
| Admin or higher
| All
| Gives that player admin powers. If not previously whitelisted on a whitelisted server, whitelists them.
|-
| '''/UNADMIN''' "player_name''
| Admin or higher
| All
| Revokes that player's admin powers. If not seperately whitelisted on a whitelisted server, unwhitelists them.
|-
| '''/RESET-OWNER''' "player_name''
| Admin or higher
| Mac and BlockServer
| The next player to log in with that player's name takes ownership of their blockheads, items, and name. Does not reset blacklist status, whitelist status, mod status, or admin status.
|-
| '''/CLEAR-BLACKLIST'''
| Admin or higher
| All
| Removes all names from the blacklist.
|-
| '''/CLEAR-WHITELIST'''
| Admin or higher
| All
| Removes all names from the whitelist.
|-
| '''/CLEAR-MODLIST'''
| Admin or higher
| All
| Revokes all moderator powers.
|-
| '''/CLEAR-ADMINLIST'''
| Admin or higher
| All
| Revokes all admin powers.
|-
| '''/SET-PASSWORD'''
| Owner or higher
| Cloud
| Sets a password that all other players must use to connect.
|-
| '''/REMOVE-PASSWORD'''
| Owner or higher
| Cloud
| Removes a password so all other players can connect.
|-
| '''/SET-PRIVACY''' ''public/searchable/private''
| Owner or higher
| Cloud
| Changes the privacy setting.
|-
| '''/SET-OWNER''' ''player name''
| Mac Console only
| Mac
| Sets the owner of a Mac server. '''Does not prevent /RESET-OWNER on the name'''
|-
| '''/REMOVE-OWNER'''
| Mac Console only
| Mac
| Removes the owner of a Mac server.
|-.
|}
 
BlockServer had additional commands that all players could use. As only mods/admins have these "invalid" commands hidden, they are publicly visible when attempted by any other player.
 
{| class="wikitable"
! scope="col" width="230px" | Command
! scope="col" | Description
|-
| '''/BSOP''' ''message''
| Sends a support request to BlockServer.
|-
| '''/OP''' ''message''
| Sends an email to contact emails set in that world's world manager, if enabled.
|-
| '''/REASSIGN''' ''old_username''
| Used for the purpose of migrating usernames due to issues moving from BlockServer to the cloud. [https://forums.theblockheads.net/t/its-time-to-migrate-from-blockserver-to-the-cloud/9794 More information]. Removed in [[Game updates/20141119|version 1.6]].
|}
 
==See also==
*[[Server List]]
 
[[Category:Guide]]
[[Category:Servers|*]]

Latest revision as of 23:17, 6 August 2024

Parts of this article are outdated, and need to be updated. 
You can help The Blockheads Wiki editing it to reflect a recent update.
Server connection screen

A server is an online world that allows multiple players and devices to play together. Unlike other forms of multiplayer, all players can freely connect, reconnect, and disconnect. A local network game is similar to a local server in that it could be used as a server if set up correctly. Starting in version 1.5, servers may also be 4x or 16x larger.

A link to a server can be shown in the following formats:

  • blockheads://(server domain or IP):(port)
  • http://theblockheads.net/join/(server domain or IP):(port)
  • http://theblockheads.net/join.php?id=(cloud world ID)&name=(world name; URL-encoded)

Nicknames

Nicknames are names used to identify an account. An unlimited number of nicknames may be created by a device on a server, but only one can be running actions from a device at any given time.

When creating a nickname, the nickname chosen cannot have been banned or have been previously used. Nicknames are required to be unique in a world on Mac servers and unique in all cloud servers on the cloud. On Mac servers, nicknames can only be logged in to from the same device it was created with, or another device sharing the same iCloud, Game Center, Google Play, or Amazon Game Circle account. On cloud servers, nicknames can only be logged into from a device sharing the support ID found at the bottom of the Help/Credits screen of the pause menu. A nickname cannot be logged in to from multiple devices at the same time.

Blockheads and their items are tied to an an account. Blockheads cannot be moved or transferred between nicknames.

Shops can only be stocked, have the price set, have the profit collected, and removed by the player who placed it.

Safes, display cabinets, and portal chests cannot accessed or removed by other players. Iron doors and iron trapdoors cannot be passed through by other players, although they may be mined through if an ownership sign is not present.

Signs, paintings, and columns cannot be removed by other players.

Chests, shelves, ladders, stairs, crafting surfaces, portals, trade portals, steam locomotives, rail handcars, elevator shafts, electric elevator motors, wooden beds, soft beds, and golden beds can be used by other players, but not removed.

In addition, each of the items above cannot be picked up if it doesn't belong to a player, except for direct player-to-player item exchanges.

However, Admins are able to remove, use, and modify anything a player has placed.

Server Hosting

Cloud Server

Added in version 1.5.1, cloud servers can be created with the app. In-app purchases are used to add credit. World Credit is added by the owner upon creation of the world, while additional time can be bought with money by any player using the World Credit option in a portal or by adding credit in the Pause Menu. They can be managed online using the owner portal.

Creating a Server

  1. Scroll to "CREATE WORLD"
  2. Tap "ONLINE", then "CREATE WORLD..."
  3. Enter name, size, and nickname/avatar, then tap "CREATE WORLD..."
  4. Choose world difficulty (normal or expert mdoe), then tap "CREATE WORLD..."
  5. Choose world type (survival or custom rules), then tap "CREATE WORLD..."
  6. Choose privacy settings, initial world credit, then tap "CREATE WORLD..."
  7. Agree to conditions by tapping "OK"

Mac Server App

Mac Server App

The Mac Server App is free and allows worlds to be hosted. It can be connected to using Local Network, or, if set up correctly, by anyone, using port forwarding to forward the correct port to a Mac. Mac servers can have up to 32 players connected at once. It requires Mac OS X 10.8 Mountain Lion or higher to run.

Creating a Server

  1. Download the server app from the Mac App Store
  2. Open the app and click "New"
  3. Enter name of server
  4. Click "Start"

Server Interface

A chat log and a chat box are located on the right hand side. A player log with player nicknames and IPs is in the middle. Banning, kicking, and whitelisting can both be done from the chat box and the interface. Other server commands can be used through the chat box.

Linux Server

The Linux Server is free and allows worlds to be hosted. It can be connected to using Local Network, or, if set up correctly, by anyone, using port forwarding to forward the correct port to a Linux device. Linux servers can have up to 32 players connected at once.

BlockServer

BlockServer home page (November 2013)
BlockServer's list of servers (November 2013)

Server hosting using BlockServer cost $0.20 USD per world per day. Each world had a public world page located at http://blockserver.net/world/ followed by the world's name. BlockServer servers could have up to 16 players connected at once. BlockServer backed up servers every day, storing a backup for two months. On June 12, 2014, BlockServer closed, and new worlds could no longer be created and new credit could no longer be added. Credit can be transferred to the game or refunded. Worlds would remain on BlockServer until credit has been exhausted, and could be transferred to the cloud system at any time.

The BlockServer website now redirects to The Blockheads website. Functionality similar to that of BlockServer has been implemented through the owner portal interface.

Powers

Mods

Mods may also ban players who have placed certain crafting surfaces. There is also the added kick and ban options when clicking on a player's icon.


Mods can use the following commands in the chat:

  • /HELP
  • /PLAYERS
  • /KICK
  • /BAN
  • /BAN-NO-DEVICE
  • /UNBAN
  • /WHITELIST
  • /UNWHITELIST
  • /LIST-BLACKLIST
  • /LIST-WHITELIST
  • /DEBUG-LOG

Admins

Admins can use all commands in the chat except for /SET-PASSWORD, /REMOVE-PASSWORD, and /SET-PRIVACY. Admin can see all areas in the world that have been explored. They may also pass through others' iron doors and iron trapdoors, and use and pick up all items, even those not owned by them. (crafting surfaces, beds, chests, safes, shelves, etc.)

Owners

Owners have the same powers as admins, with the additional ability of being able to set passwords and change privacy settings. Owners are by default set to the creator of a cloud server.

Owners of Mac Servers can be set using the /SET-OWNER command.

Super Mods

Super Mods are identified by a red background.

Super Mods have absolute power on all cloud server worlds on The Blockheads. Super Mods are part of The Blockheads Team and have the ability to set or remove owners of a cloud server and do various tasks that only Super Mods can do.

Super Mods can not be Muted, Reported, Banned or Kicked as indicated in the thumb on the right.

Current Super Mods:

  • Dave Frampton (majicDave)
  • Camilla Koutsos (milla)
  • NoodleCake (NoodleKing)

Server Commands

Server commands are done through the chat. Only admins and mods can use server commands. All commands are case-insensitive, for both the command itself and its input. Commands are not shown to the public, nor are their responses.

Command Powers required Server type Description
/HELP Mod or higher All Displays the in-game list of commands. Only displays commands available to the player who used it.
/PLAYERS Mod or higher All Lists all players on the server who aren't away or offline. The list is presented in this manner:

(player name) | (IP address) | (unique device identifier)

/KICK player_name Mod or higher All Disconnects that player from the server. They can still reconnect.
/BAN player_name_or_ip Mod or higher All Disconnects that player/IP from the server, and prevents anyone using that nickname, device, or IP from reconnecting.
/BAN-NO-DEVICE player_name_or_ip Mod or higher All Disconnects that player/IP from the server, and prevents anyone using that same nickname/IP from reconnecting.
/UNBAN player_name_or_ip Mod or higher All Removes player/IP from the blacklist, and allows them to reconnect. The identifier that was banned must be unbanned.
/WHITELIST player_name_or_ip Mod or higher All Adds player/IP to the whitelist. If there was no whitelist previously, everyone else is disconnected.
/UNWHITELIST player_name_or_ip Mod or higher All Disconnects that player/IP from the server, and removes them from the whitelist. The identifier that was whitelisted must be unwhitelisted.
/LIST-BLACKLIST Mod or higher All Lists the 50 most recently added players to the blacklist.
/LIST-WHITELIST Mod or higher All Lists the 50 most recently added players to the whitelist.
/DEBUG-LOG Mod or higher All Lists debug data.
/STOP Admin or higher All Turns off the server. If a cloud server or on BlockServer, instead restarts the server.
/LIST-MODLIST Admin or higher All Lists the 50 most recently added mods.
/LIST-ADMINLIST Admin or higher All Lists the 50 most recently added admins.
/PVP-ON Admin or higher All Enable PVP, allowing players to directly attack each other
/PVP-OFF Admin or higher All Disables PVP, preventing players from directly attacking each other
/LOAD-LISTS Admin or higher All Checks the whitelist, blacklist, modlist, and adminlist files for pending changes, and applies them.
/MOD player_name Admin or higher All Gives that player moderator powers. If not previously whitelisted on a whitelisted server, whitelists them.
/UNMOD player_name Admin or higher All Revokes that player's moderator powers. If not seperately whitelisted on a whitelisted server, unwhitelists them.
/ADMIN "player_name Admin or higher All Gives that player admin powers. If not previously whitelisted on a whitelisted server, whitelists them.
/UNADMIN "player_name Admin or higher All Revokes that player's admin powers. If not seperately whitelisted on a whitelisted server, unwhitelists them.
/RESET-OWNER "player_name Admin or higher Mac and BlockServer The next player to log in with that player's name takes ownership of their blockheads, items, and name. Does not reset blacklist status, whitelist status, mod status, or admin status.
/CLEAR-BLACKLIST Admin or higher All Removes all names from the blacklist.
/CLEAR-WHITELIST Admin or higher All Removes all names from the whitelist.
/CLEAR-MODLIST Admin or higher All Revokes all moderator powers.
/CLEAR-ADMINLIST Admin or higher All Revokes all admin powers.
/SET-PASSWORD Owner or higher Cloud Sets a password that all other players must use to connect.
/REMOVE-PASSWORD Owner or higher Cloud Removes a password so all other players can connect.
/SET-PRIVACY public/searchable/private Owner or higher Cloud Changes the privacy setting.
/SET-OWNER player name Mac Console only Mac Sets the owner of a Mac server. Does not prevent /RESET-OWNER on the name
/REMOVE-OWNER Mac Console only Mac Removes the owner of a Mac server.

BlockServer had additional commands that all players could use. As only mods/admins have these "invalid" commands hidden, they are publicly visible when attempted by any other player.

Command Description
/BSOP message Sends a support request to BlockServer.
/OP message Sends an email to contact emails set in that world's world manager, if enabled.
/REASSIGN old_username Used for the purpose of migrating usernames due to issues moving from BlockServer to the cloud. More information. Removed in version 1.6.

See also