Skip to content

Commit 42f1182

Browse files
author
Julien
committed
Merge branch '2StepsFr0mHell'
2 parents 4e3d4ea + af1a64e commit 42f1182

File tree

5 files changed

+9
-55
lines changed

5 files changed

+9
-55
lines changed

playground/core-concepts/core-4-configuration.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ max_players=2
3737

3838
You may add to the config/ folder a text file named `stub.txt`. If the contents of this file is a syntaxically valid **CodinGame Stub Generator** input, the IDE will be prefilled with input/output code.
3939

40-
See [Stub Generator Syntax](https://github.com/CodinGame/codingame-game-engine/blob/master/stubGeneratorSyntax.md) for details.
40+
See [Stub Generator Syntax](https://www.codingame.com/playgrounds/40701/contribute---help/stub-generator-syntax) for details.
4141

4242
### Loading assets <a name="loading-assets"></a>
4343

@@ -120,6 +120,8 @@ Within the `.tpl` file, you may place special comment blocks to indicate whether
120120

121121
Optionally, you can tranlate your statements in French using `statement_fr.html` files.
122122

123+
Learn more about how to write a statement for sdk games in the [CodinGame contribution documentation](https://www.codingame.com/playgrounds/40701/contribute---help/writing-the-statement#game-statement)
124+
123125
#### Example
124126

125127
This `statement_en.html.tpl`:

playground/getting-started/tutorial-1-introduction.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -16,10 +16,11 @@ The entry point of the game is the class `SoloGameManager` or `MultiplayerGameMa
1616

1717
![Main classes](resources/schema-sdk.svg)
1818

19-
# Resources
19+
# Useful Resources
2020

2121
- [Javadoc](https://codingame.github.io/codingame-game-engine/)
2222
- [SDK source](https://github.com/CodinGame/codingame-game-engine)
2323
- [Free to use graphical assets](https://github.com/CodinGame/codingame-sdk-assets)
2424
- [Game Skeleton](https://github.com/CodinGame/game-skeleton)
25-
- [Contribute Page](https://www.codingame.com/contribute/)
25+
- [Contribute Page](https://www.codingame.com/contribute/)
26+
- [Contribution Documentation](https://www.codingame.com/playgrounds/40701/contribute---help)

playground/getting-started/tutorial-2-multiplayer.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -77,7 +77,7 @@ Use this page to see the rendering of your game. It also allows you to export a
7777

7878
## Deploy on codingame
7979

80-
Go to [www.codingame.com](https://www.codingame.com), then click on **Contribute** > **Create a new puzzle** > **Multiplayer Game** (This section is not available to anyone yet, please contact us if you want the access).
80+
Go to [www.codingame.com](https://www.codingame.com), then click on **Contribute** > **Create** > **Multiplayer Game**.
8181

8282
Then, import on CodinGame the game you have exported during the previous step. The game will be compiled on our servers and a preview link will appear if the compilation succeeded and if the configuration is correct.
8383

playground/getting-started/tutorial-3-solo.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -80,7 +80,7 @@ Use this page to see the rendering of your game. It also allows you to export a
8080

8181
## Deploy on codingame
8282

83-
Go to [www.codingame.com](https://www.codingame.com), then click on **Contribute** > **Create a new puzzle** > **Solo Game** (This section is not available to anyone yet, please contact us if you want the access).
83+
Go to [www.codingame.com](https://www.codingame.com), then click on **Contribute** > **Create** > **Solo Game**.
8484

8585
Then, import on CodinGame the game you have exported during the previous step. The game will be compiled on our servers and a preview link will appear if the compilation succeeded and if the configuration is correct.
8686

Lines changed: 1 addition & 50 deletions
Original file line numberDiff line numberDiff line change
@@ -1,50 +1 @@
1-
# Guidelines
2-
3-
When creating your game, we suggest you follow these guidelines in order to improve both its performance and players experience.
4-
5-
## Technical Guidelines
6-
7-
- The game should be noob friendly. Can make a workable AI with a bunch of ifs.
8-
- If it is a game with limited output options per turn, send those options in the protocol (e.g. the first player of chess has 20 possible actions).
9-
- Viewer should be enough to understand most of the rules.
10-
- Gameplay based around rounds/turns. Only perform checks (collision, presence, etc.) at the end of a turn.
11-
- End player’s program when it outputs an unrecognised command. Continue player’s program when it outputs a recognised but invalid command and add error message to summary.
12-
- Stop game early if players aren’t doing anything or are otherwise stalemated.
13-
- Stop game early if the ranking is decided whatever the players may do.
14-
- Always minify png and jpg assets.
15-
- The Referee must not crash, make sure all possible exceptions are caught, especially during the parsing of a Player’s actions, where most errors occur.
16-
- Minimum font size: 36px.
17-
18-
## Soft Limits
19-
20-
The following limits will make your game run faster, but they are not strict limitations.
21-
22-
- Statement length: less than 6k characters
23-
- Total entity creations: less than 200.
24-
- Max total time alloted to the players: 25s.
25-
26-
## Protocol:
27-
28-
The following lines will help most players to get into your game. Try to simplify things when possible.
29-
30-
- Two loops max for input.
31-
- Variables to read per loop: less than 10.
32-
- Stub generator must not exceed: 45 lines of Java.
33-
- If the player is given an ID, it is always 0.
34-
35-
## Graphics:
36-
37-
- Privilege the use of Sprites over Shapes (Rectangle, Circle, etc.)
38-
- Use less than 2Mb total for assets.
39-
40-
## Games with leagues
41-
42-
- Stubs should, if possible, be the same for every league.
43-
- If a game needs at least 1 data structure to make an AI that doesn’t crash, it needs an easier league.
44-
45-
## Rules
46-
47-
When contributing on CodinGame, you must accept and apply these rules:
48-
49-
- Your game must not contain any kind of inappropriate content.
50-
- Write a stub generator. The documentation can be found in the [CodinGame SDK repository](https://github.com/CodinGame/codingame-game-engine/blob/master/stubGeneratorSyntax.md). Any non-explicit variable must be explained with a comment.
1+
Guidelines and best practices for coding games can be found in the documentation ["Contributing to CodinGame"](https://www.codingame.com/playgrounds/40701/contribute---help/coding-games#guidelines)

0 commit comments

Comments
 (0)