SOKOBAN 3D GAME

Description

https://github.com/zukahai/sokoban-3d/assets/85035951/bc061f7f-dc4e-4c92-b09d-c8b09f2b0672

This is a puzzle game where your task is to move the black cube to the position of the ball. To move the cube, simply press the arrow keys on the keyboard. The game features various puzzle elements such as secret rooms, stairs, doors, keys, etc. You need to find a way to overcome these obstacles to reach the position of the ball.

Installation

Play directly here

Contribute a Level

Create Your Own Level

Access: https://sokoban-3d.vercel.app/create/

Table of Contents:

Preview Your Level
Change Block Heights
Add Rows and Columns
Add Starting Point
Change Ending Point
Add Regular Cubes
Add Climbing Cubes
Add Regular Switches
Add Hold Switches

1. Preview Your Level

Press Enter to preview your level:

For example, with the image below:

After pressing Enter, the level will be displayed as follows:

2. Change Block Heights

Change the block heights by clicking on the cells. The values will range from 0 to 9, representing the heights of the blocks.

3. Add Rows and Columns

Press ↑ to add a row above
Press ↓ to add a row below
Press ← to add a column on the left
Press → to add a column on the right

4. Add Starting Point

Press S and select the cell where you want to place the starting point.

5. Change Ending Point

Press K and select the cell where you want to place the ending point.

6. Add Regular Cubes

Press P and select the cell where you want to place a regular cube.

7. Add Climbing Cubes

Press Q and select the cell where you want to place a climbing cube.

8. Add Regular Switches

Press B to display the following:

Click on the green cell to change the depth when the switch is activated. The number 1 means that the designated cell will decrease its depth by 1 when the switch is pressed. The number -1 means that the designated cell will decrease its depth by 1 when the switch is pressed.

Select the cell to place the switch, then select the cell that the switch will activate.

9. Add Hold Switches

Press M and follow the same steps as regular switches.

How to Add Your Level to the Game

You can send me a direct message on Facebook: Phan Đức Hải and send me the data.txt file.

If you have a GitHub account, you can add your level to the game by following these steps:

Go to https://sokoban-3d.vercel.app/create/

Press H to create a file named data.txt. Copy the content of this file and follow the instructions.

Access: https://github.dev/zukahai/sokoban-3d-game

Wait for the web page to load, it will appear as shown below:

Select config.js, inside it is the current number of levels. You need to increase it by 1. For example, if there are currently 21 levels, you need to change it to 22.

Continue to select assets, wait for it to load, then select levels. The window will appear as shown below:

Click on the icon as shown below to create a new file named levelX.json, where X is the number of your level. For example, if you want to create level 22, you need to create the file level22.json.
Note: The GitHub.dev system loads continuously, so sometimes it may not receive the signal to create the file. You need to be patient and perform this operation multiple times if you don't see the system asking for the file name.

Then paste the content of the data.txt file into the newly created levelX.json file. Remember to change the indexLevel part to X in the levelX.json file. For example, if you are creating level 22, you need to change it to var indexLevel = 22;.