Skip to content

Commit

Permalink
Added "Connect to the Server" and "Basic Administration" pages
Browse files Browse the repository at this point in the history
  • Loading branch information
aramperes committed Apr 16, 2018
1 parent 1fb03e7 commit b03d768
Show file tree
Hide file tree
Showing 4 changed files with 84 additions and 0 deletions.
Binary file added Getting_Started/add_server_dialog.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
57 changes: 57 additions & 0 deletions Getting_Started/basic_admin.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,57 @@
Basic Administration
====================

Administration tasks are done through commands, either inside the console (the terminal) or by players (in-game).
These commands are used in the form :code:`<command> [arguments...]`.

When describing a command, words inside angled brackets (:code:`<...>`) represent **required** arguments, while square
brackets (:code:`[...]`) represent **optional** arguments.

.. note::

When using commands in-game, the forward-slash prefix (:code:`/`) is added.

For example, a player would use :code:`/kick otherplayer You are evil`, while the console operator would use
:code:`kick otherplayer You are evil`.

For the sake of consistency, the prefix will not be used in this documentation.

Operators
---------

In order to give permission to a player to use administration commands, they will need to be made **operators** of the server.

A player can be added as a server operator using the :code:`op <player>` command. For example, to add a player named "glowstoner" as an operator,
use the command :code:`op glowstoner`.

Similarly, to remove a player as an operator, use :code:`deop <player>`. For example, :code:`deop glowstoner`.

Players that attempt to use administrative commands without operator privileges will receive an error.

Kicking and Banning Players
---------------------------

In order to kick a player from the server, use the :code:`kick <player> [reason]` command. The first argument
is the name of the target player, and is required. The remainder of the command is optional and will be shown
to the kicked player.

For example, :code:`kick glowstoner Not today!` would show "Not today!" on `glowstoner`'s client.

Kicking a player is considered a "temporary" punishment, because the player can still log back into the server after
being disconnected. In order to **ban** a player from joining the server, use the similar :code:`ban <player> [reason]` command.

In order to un-ban a player, use the :code:`pardon <player>` command.

Whitelisting
------------

Whitelisting allows you to limit which players can join the server. When enabled, players not on the whitelist will
not be able to join the server.

In order to enable the whitelist, use the :code:`whitelist on` command. Similarly, use :code:`whitelist off` to
disable it.

To add a player to the whitelist, use :code:`whitelist add <player>`. Oppositely, use :code:`whitelist remove <player>`
to remove them.

Operators can list players currently inside the whitelist using :code:`whitelist list`.
25 changes: 25 additions & 0 deletions Getting_Started/connect.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
Connect to the Server
=====================

Once your server is open on a port, you can connect to it using a Minecraft client.

For the sake of demonstration, we will assume you are running your server locally on port :code:`25565`.

1. Click on the **Multiplayer** button in the Minecraft main menu.
2. Click on **Add Server**.
3. Fill in a server name, and then set the **Server Address** to :code:`localhost:25565`. It should look something
like this:

.. image:: add_server_dialog.png
:scale: 50 %

4. Click on **Done**. Your server should now appear in your server list.

.. note::

Sometimes, your server will show as unavailable ("`Can't connect to server`") after you add it to the server list.

If that is the case, click on **Refresh**, and it should be live.

5. Select your server in the list, and click on **Join Server**. After a few seconds, you should spawn in your server's
world.
2 changes: 2 additions & 0 deletions Getting_Started/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,8 @@ Installing Glowstone is as easy as installing any other server software.
install_java
install_glowstone
first_run
connect
basic_admin
plugins


Expand Down

0 comments on commit b03d768

Please sign in to comment.