Skip to content

Help

Jump to bottom
coobbi edited this page Apr 12, 2026 · 2 revisions

How to Use Minecraft Server: MCPaper

Minecraft Server: MCPaper lets you run a Paper-based Minecraft Java server directly on your Android device.

This app does not include a server JAR file.
Before starting the server, you need to download a compatible server JAR file yourself, such as Paper, from the official website.

Quick Start

Using MCPaper is simple:

Step 1: Download paper.jar

First, download a compatible Paper server JAR file from the official Paper website and save it on your device.

Step 2: Open MCPaper and Select the JAR File

Open Minecraft Server: MCPaper and choose the paper.jar file you just downloaded.

Step 3: Server Starts Automatically

After you select the JAR file for the first time, MCPaper will automatically start the server.
You do not need to tap Start after selecting it.

That’s it.

First Time Setup

The first time you use MCPaper:

  1. Download paper.jar from the official source
  2. Open MCPaper
  3. Select the downloaded JAR file
  4. The server will start automatically

MCPaper will remember the selected JAR file automatically.

Starting the Server Again

After the first setup, you do not need to select the JAR file again every time.

The app remembers the last selected server JAR, so next time you can simply:

  1. Open MCPaper
  2. Tap Start

The server will start using the previously selected JAR file.

If needed, you can still manually choose another JAR file later.

How to Join the Server

After the server has started successfully, you can join it from Minecraft Java Edition.

Join from the same local network

If the Android device running MCPaper and the player’s device are on the same Wi-Fi network, follow these steps:

  1. Open Minecraft Java Edition
  2. Go to Multiplayer
  3. Click Add Server
  4. Enter the local IP address of the Android device running MCPaper
  5. Enter the server port

The default port is usually:

25565

  1. Save the server
  2. Join the server

Example

If your Android device IP address is:

192.168.1.23

and the port is:

25565

then the server address will be:

192.168.1.23:25565

If you changed the server port

If you changed the port in server.properties, use the new port instead.

For example:

192.168.1.23:25566

Important: Online Mode Setting

In some cases, you may need to set Online Mode to Off before players can join successfully.

This is controlled by the online-mode setting in server.properties.

How to change it

Open server.properties and change:

online-mode=true

to:

online-mode=false

Then save the file and restart the server.

When this may be needed

This may help in some local network or special connection setups where players are unable to join normally.

Important note

Turning Online Mode off changes how the server handles player authentication.
Only use this setting if you understand what it does and if it is appropriate for your server setup.

About Public Network Access

By default, MCPaper is intended for local network access.

If you want players outside your local network to join, additional setup is required and must be done manually by the user.

Possible methods include:

  • installing required server plugins
  • using a tunneling or port forwarding app/service
  • using a network penetration / remote access tool

Please note:

  • MCPaper does not automatically enable public Internet access
  • public access depends on your network environment and third-party tools
  • some methods require extra apps, plugins, or manual configuration

Server Console

When the server starts, MCPaper opens the live console screen.

In the console, you can:

  • view startup logs
  • monitor server activity
  • see player join and leave messages
  • enter Minecraft server commands

Examples of commands:

  • help
  • list
  • say Hello
  • save-all
  • stop

Important: Accept the EULA

When starting the server for the first time, Paper may generate an eula.txt file.

If the server does not continue and asks you to accept the EULA:

  1. Open eula.txt
  2. Change:

eula=false

to:

eula=true

  1. Save the file
  2. Start the server again

Useful Notes

  • MCPaper does not include Paper or any server JAR files
  • You must download your own compatible server JAR first
  • The app remembers the last selected JAR file automatically
  • The first time you select a JAR file, the server starts automatically
  • After that, you can usually start the server again with one tap
  • In some cases, you may need to set online-mode=false
  • Device performance depends on available RAM, CPU, and storage

Troubleshooting

The server does not start

Check that:

  • the selected JAR file is valid
  • the file was not deleted or moved
  • the EULA has been accepted
  • your device has enough memory available

I want to use another server JAR

Open MCPaper and select a different JAR file manually. The app will remember the new one for future starts.

Players cannot connect

Make sure:

  • the server has fully started
  • the correct IP address and port are being used
  • both devices are on the same Wi-Fi network for local play
  • if needed, try setting online-mode=false
  • if using public access, the required plugins or tunneling tools are set up correctly

Simple Summary

First time:

  • Download paper.jar
  • Select it in MCPaper
  • The server starts automatically

Next time:

  • Open MCPaper
  • Tap Start

To join locally:

  • Open Minecraft Java Edition
  • Add a server using your Android device local IP and port
  • Join the server

If players cannot join:

  • Check the IP and port
  • Make sure the server has fully started
  • If necessary, set online-mode=false in server.properties

To allow public access:

  • Extra manual setup is required, such as plugins or tunneling tools

Clone this wiki locally