What Oneblock is and how to add it to Aternos
Oneblock is a Minecraft game mode where you spawn on a single block floating in the void. As you break that block, new ones generate beneath your feet in a set sequence, giving you resources to build with and survive. Aternos is a free server hosting service that lets you run a Minecraft world online without paying for a dedicated server.
To add Oneblock to an Aternos server, you install a plugin called OneBlock that controls how the block generation works. The plugin runs on the server side, meaning you do not need to install anything on your own computer — only the people playing on your server need the base Minecraft game.
The process takes about five minutes and requires you to read one file, upload it to your Aternos server, and restart. This guide walks you through each step in order.
Key Takeaways
- Oneblock requires a plugin file that you read from Spigot or Bukkit, then upload to your Aternos server's plugins folder.
- Your Aternos server must be running Spigot or Paper (not vanilla Minecraft), which you can change in the server settings before uploading the plugin.
- After uploading the plugin file, you restart the server from the Aternos dashboard, and the plugin loads automatically.
- Once the server restarts, players join normally and spawn on the single block — no additional setup is needed in-game.
- If the plugin does not load, check that the server is running Spigot or Paper and that the plugin file is in the correct folder.
Check your server type before downloading the plugin
Oneblock is a plugin, which means it only works on servers running Spigot or Paper — not on vanilla Minecraft servers. If your Aternos server is currently set to vanilla, you need to change it first.
Log into your Aternos account and open your server dashboard. Click the menu icon (three horizontal lines) in the top left, then select Settings. Scroll down to the section labeled Server Type and click the dropdown. Select Spigot or Paper (Paper is slightly faster and more stable, but either works). Click Save at the bottom of the page. Aternos will ask you to confirm — click Confirm. Your server will stop and rebuild with the new server type, which takes about one minute.
If your server is already running Spigot or Paper, you can skip this step and move to downloading the plugin.
read the Oneblock plugin file
Open a web browser and go to spigotmc.org. In the search box at the top of the page, type "OneBlock" and press Enter. Look for the result titled OneBlock by tastybento (the author's name appears below the title). Click on it to open the plugin page.
Scroll down until you see a button labeled read Now (it is usually blue or green). Click it. Your browser will read a file with a name like OneBlock-3.x.x.jar (the numbers may be different depending on the version). The file is small — usually under 1 megabyte — so it downloads in a few seconds.
Do not unzip or open this file. Leave it as a .jar file and remember where your browser saved it (usually your Downloads folder).
Upload the plugin to your Aternos server
Go back to your Aternos server dashboard. On the left side menu, click Files. You will see a folder view of your server's files. Look for a folder named plugins and double-click it to open it. If you do not see a plugins folder, create one: click the New Folder button, type "plugins", and press Enter.
Inside the plugins folder, click the Upload button (usually in the top right). A file browser window will open. Navigate to where your browser saved the OneBlock .jar file, select it, and click Open. Aternos will upload the file to your server. You will see it appear in the plugins folder when the upload finishes.
Do not rename the file or move it to a different folder. The server looks for plugin files specifically in the plugins folder.
Restart your server to load the plugin
Go back to your Aternos server dashboard (click the home icon or "Dashboard" in the left menu). At the top of the page, you will see a large button labeled Start. If your server is already running, click the Stop button first to shut it down. Wait about 10 seconds, then click Start to turn it back on.
The server will take about 30 to 60 seconds to start. You will see a progress bar or status message. When the status shows Online in green, the server has finished starting and the OneBlock plugin has loaded.
If you see an error message or the server does not start, go back to the Files section and check that the OneBlock .jar file is in the plugins folder. If it is missing or in the wrong place, upload it again.
Join the server and spawn on the block
Open Minecraft and click Multiplayer. Click Add Server. In the Server Name field, type a name for your server (anything you want — this is just for you). In the Server Address field, copy and paste the address from your Aternos dashboard (it appears near the top and looks like "play.aternos.org" followed by a colon and numbers).
Click Done. Your server will appear in the server list. Click it and then click Join Server. Minecraft will connect and load the world. You will spawn on a single block floating in the void. Break the block beneath your feet, and new blocks will generate as you fall, giving you resources to collect and build with.
Other players can join the same way using the same server address. They will also spawn on the Oneblock world and can play together.
Troubleshooting if the plugin does not load
If you join the server and the Oneblock world does not appear (you spawn in a normal world instead), the plugin did not load. The most common cause is that the server is still set to vanilla Minecraft. Go back to Settings, check the Server Type, and make sure it says Spigot or Paper. If it still says vanilla, change it and restart the server again.
The second most common cause is that the plugin file is in the wrong folder or has a different name than expected. Go to Files, open the plugins folder, and confirm the OneBlock .jar file is there. If it is not, read it again and upload it to the plugins folder. Then restart the server.
If the plugin file is in the correct folder and the server type is correct, but the plugin still does not load, the plugin version may not be compatible with your server version. Try downloading a different version of OneBlock from the Spigot page (older versions are listed below the main read button) and upload that instead.
Frequently Asked Questions
Can I use Oneblock on a server I already have a world on?
Yes, but it will create a new world separate from your existing one. When you install the Oneblock plugin, it generates a world called "oneblock" by default. Your old world remains unchanged. Players can switch between worlds by using commands or by creating separate servers.
Do my friends need to install anything to play on the Oneblock server?
No. They only need the standard Minecraft game. The plugin runs on the server, so all the Oneblock logic happens on your Aternos server. Your friends straightforward join like they would any other multiplayer server.
What if I want to change Oneblock settings, like how fast blocks generate?
The OneBlock plugin creates a configuration file in the plugins folder after the first restart. You can edit this file to change settings like generation speed and block types. Open the plugins folder, find the OneBlock folder inside it, and look for a file named config.yml. You can edit it directly in Aternos's file editor, but changes only take effect after you restart the server.
Can I remove Oneblock and go back to a normal world?
Yes. Go to Files, open the plugins folder, and delete the OneBlock .jar file. Restart the server. The plugin will no longer load, and new players will spawn in a normal world. Your old Oneblock world files remain on the server but will not be used unless you reinstall the plugin.
Why does my server say it is offline even though I clicked Start?
Aternos servers go offline after 30 minutes of no players connected to save resources. Click Start again to turn it back on. This is normal and not a problem with the plugin.