Freecode creator
You can design and publish your own Challenges, Exercises, and Freecodes
The Creator is very similar to the Freecode Editor which you can read more about here: Freecode editor on Future Skill using the Freecode Creator. Just sign in, click Create, and select Freecode to get started.
The Implementation Tab
This is where you as the author design your Freecode:
- Write your creator code: call solution methods, generate graphics, define scoring.
- It acts as the “engine” behind the Freecode.
- For detailed logic patterns, visit the Skeletons page (link).
The Solution Tab
The solution tab contains a default solution that is used when running the code in the creator. This is not visible for the Members when opening the Freecode. Here you as the author can create a solution to your own Freecode to try it. The member will see the methods with just the default return values (See API Tab). This solution is also the default solution used in contests when there are no other contestants to compete against.
The API Tab
Manage two types of APIs:
- Implementation APIs: provide supporting methods for users.
- Solution APIs: define the stubs users must implement.
Add Implementation API
The implementation methods are the methods that you as a creator provide to the taker of your Freecode. This gives the taker the ability to call your API to get information that you make available to them. Brings up the dialog to add a method to the implementation. After the method is added the method with the given signature is added automatically to the implementation.
Add Solution API
The solution methods are the methods that the user that takes the Freecode fills in to create their solution. Clicking the button brings up the dialog to add a method to the solution. After the method is added the method with the given signature is added automatically to the solution.
While adding solution api using Future Skill Gpt use the instructions below:
Solution API - A Solution API is a Python function template created for the user to input their solution for a specific task at a specific level. - A Solution API is a template and must not contain any actual solution or logic - The function must always end with the following lines:
1 2 |
|
Function Name
The function name must include the word "level", followed by the level number, and a descriptive phrase of what the function does. For example: If you're creating a function for level 1 that adds names to a table, the function name should be:
1 2 3 |
|
Argument Type
Arguments passed to the Solution API can only be one of the following types: - int - bool - double - string - bytes - list - map
Return Type
The return value must also be one of the following types: - int - bool - double - string - bytes - list - map
Solution API Format
1 2 3 4 5 6 7 8 9 10 |
|
List Handling - if argument type or return type is a list show the type of the values in the list as follows:
list[
Regenerate Skeletons
Regenerates the skeletons for all the different languages. These can be viewed under the Preview tab. This is what the user who takes the Freecodes starts from. The python skeleton is equivalent to what you see in the solution tab after you press "Reset Solution"
Reset Implementation
Resets the implementation. This will remove any code written by you in the implementation tab and give you the empty skeleton code with the implementation methods from the API tab.
Reset Solution
Resets the solution. This will remove any code written by you in the solution tab and gives you the empty methods from the solution API. This can be good to use if you have added and removed Solution APIs and want to make sure you are writing for the latest functions.
Create API Method
All method names must be space-separated list of words containing lowercase letters and can't start with a number. Specific language formatting is applied automatically. Default return values for different return types in solution methods:
Data type | Default return value |
---|---|
int |
-2 |
double |
-2.0 |
bool |
False |
string |
'Foo' |
byte |
b'foo' |
list |
[] |
map |
{} |
For implementation methods you get raise NotImplementedError('"APImethod" not implemented') as default regardless of the return type.
The Graphics Tab
Configure canvas, animations, images, and resolution:
- Enable/disable canvas and animations.
- Upload PNGs or sprite sheets.
- Set canvas resolution, background color, and thumbnails.
Canvas Animation
- Uses Canvas:
- Check this if the canvas will be used.
- Has Canvas Animation:
- Check this to enable canvas animations. This will additionally add the option Canvas step time (ms), which will determine how many milliseconds will pass between each canvas animation step.
- Supports Interact:
- Check this to enable interactive mode. This will additionally add one check box for each level to determine what levels will be interactable.
- Interact using Human Adapter:
- Lorem ipsum
- Interact using separate step time:
- Check this to set a different step time in the interactive mode. This will additionally add the option Interact step time (ms), which will determine how many milliseconds will pass between each canvas animation step in the interactive mode.
If the canvas should be used, if it should be animated, and if the implementation supports human input. If the canvas is animated then there is also a setting for how long each animation step should be.
Images
Here you can upload images to be used as graphical elements in the canvas. The possible usages are individual bitmaps or as sprite sheets.
Images should typically be PNG image files with transparent backgrounds for the best result. There are many built in images that can be accessed without any need to upload them, see Built in images for a full list.
Sprite sheets needs a separate image atlas that define where each image in the sheet is placed, this atlas has to be in json format compatible with pixi.js. You can read more about this on the Create Prite Sheet page.
Background Color
The canvas background color is the color that will be displayed as a background behind any graphical elements that are added in the implementation.
Default background colors:
- Light mode: #F2F5F7
- Dark mode:
Resolution
The resolution decided the dimensions of the canvas element, and what coordinates should be used to display elements in the implementation. 10x20 will have the same dimensions as 100x200, but in order to display graphics precise locations in a 10x20 canvas you might have to use more decimal points than if the canvas is 100x200. Additionally, some graphics elements will display differently at different resolutions.
Landing Page Image
The default landing page image used by challanges and exercises. This image will be used as both background and thumbnail for the implementation.
Settings Tab
Configure Freecode metadata:
- Select challenge type, difficulty, tournaments.
- Set public/hidden levels, performance thresholds.
- Enable community sharing, official tag, and version control.
- A mismatch between the total number of levels and the number of levels in the implementation
_configurations
variable can lead to an error.
Test Meta
- Is Tournament:
- This setting is only visible if when the type of Freecode is set to Challenge. When checked this setting turns the Challenge into a Tournament. For an explanation of the difference between Challenge and Tournament see: Coding Community
- Number of players:
- This setting is only visible if "Is Tournament" is checked. This setting will determine the number of solution that will compete against each other in every run.
- Is Freecode:
- This setting is only visible when the type of Freecode is set to Exercise. When checked this setting turns the Exercise into a Freecode. For an explanation of the difference between Exercise and Freecode see: Coding Community
- Difficulty:
- This is the displayed difficulty for the Freecode in the Freecode browser.
Level Settings
- Number of public levels:
- These are the levels that the members can see when taking your Freecode.
- Number of hidden levels:
- This is only used for the "Code test" and "Challenge" type of Freecode. These levels are hidden and can't be seen by the member. These are the levels that are used for the scoring of the Freecode. So normally extra edge cases are used in these levels to see that the members solution can handle all the edges that you are a part of the Freecode.
- Exercise:
- For exercises there are only public levels, however only 1 is available at the time. This means the member must complete one levels before being able to continue to the next one. There is no hidden scoring here.
- Code test and challenges:
- The public levels are what is visible to the member when taking the Freecode. These are the levels that they can try their solutions against and see if they pass. These levels are not used in scoring the Freecode. That is handled in the hidden and performance levels.
- Performance levels:
- This is only used for the Code test type of Freecode. On top of the normal correctness check of the solution an additional check of how much times was used is added. You as the author must specify this time limit in milliseconds for each of the programming languages available on Future Skill. For performance levels using much larger input data is recommended. The time limit if set per language.
Good performance scores
Only available for code tests with Performance levels.
Community
- Public Implementation:
- When this is checked your Freecode will be available to other community members to copy and use as a starting point for their own Freecodes. Only checking this will not allow them to see your solution. So it cant be used for cheating.
- Public Solution:
- When you make your solution available members will be able to see and copy your solution. So this can lead to "cheating", especially in the case of Exercises.
- Use official tag:
- When this is checked your Freecode will have the official tag.
- Is Flow:
- When this is checked your Freecode will have a flow, see more on the Flow page.
Versioning
Manage versions of the implementation. Using this it is only possible to move forwards in versions with 1 live version and 1 work in progress version. It is still possible to open old versions and export them to test them out or to import as the current version.
The Preview Tab
The preview tabs show you the code the user from use as a starting point in the available languages.
You can also see the API methods available to the user with the languages specific formatting. The solution methods are the method signatures the user taking the Freecode will see and are the same methods that are in the skeletons above. The Challenge methods are the signatures for the API tab the member will see and use when taking the Freecode.
Descriptions
Description
This is the descriptions that a user can see in the editor when participating in a challenge or taking an exercise. This description should contain details about what to do, how it can be done, and how the result will be scored.
Use the description structure below :
- Provide a general description of the challenge or exercise (should not have theoretical knowledge about the topic).
- Use semi-formal but simple, clear language.
- A light joke or two is okay, but the tone should stay informative — not humorous overall.
- See the Tags section below for instructions on how to use tags when building the topic description.
- Provide the information in both English and Swedish, directly one after the other if needed:
- English text must be wrapped with [english] ... [/english].
- Swedish text must be wrapped with [swedish] ... [/swedish].
- A challenge or an exercise has levels. Use the structure below for levels:
- Each difficulty level must start with [level
] and end with [/level ]. - Give each level a descriptive name that acts like a title for that level’s task.
- Each level must include the following:
- A part of the challenge or exercise description that user must solve in that level
- An example showing both input and output.
- An explanation of the example
- An API Helper Function explanation (if needed)
- Do not mention or include anything about the Solution API.
- Write all the information both in English and Swedish, directly after each other:
- English text must be wrapped with [english] ... [/english].
- Swedish text must be wrapped with [swedish] ... [/swedish].
- Each level may include an implementation APIs
- Introduce the implementation API as part of the task (e.g., "You can use the following function to...").
- Make sure the task is easy to follow, logically structured, and visually clear where needed.
- All content must be bilingual if it needed by a user otherwise default is English:
- Use [english] ... [/english] for English text.
- Use [swedish] ... [/swedish] for Swedish text.
- Always use the tags described below when it is needed.
Tags
You can use special tags to manage what text is displayed. To write text which only is visible when Level 1 is selected in an exercise, write:
Using level tags
1 2 3 |
|
You can also use [level2]
, [level3]
and so forth.
To write text only visible when certain languages are selected you can change the value in the tags to one of c, c_sharp, cpp, go, java, javascript, php, python, ruby, scala, typescript, rust, kotlin.
Using language tags
1 2 3 4 |
|
You can also do tags that are visible for multiple levels and/or languages by separating the tags with |
Combining tags
1 2 3 4 |
|
If you want a default value there is also a switch options.
Using a switch tag
1 2 3 4 5 |
|
Here is a logical equals operator: "is" or "==" depending on what you are comparing
Here is a logical equals operator: ===
Here is a logical equals operator: ===
Here is a logical equals operator: ==
Finally there is also a translation dict that can replace multiple instances of the same text based on the contents.
The text to replace must be prepended with a *
.
Each word or phrase to replace needs its own translation definition.
If there is no match or default text the from text will be replaced with an empty string.
Using a translate tag
1 2 3 4 5 6 |
|
*hello
in our flow, it will be rendered as something different depending on which language you are using.
HELLO!!!!
_h_e_l_l_o_
_h_e_l_l_o_
h e l l o . . .
Summary
This is the public description used externally to entice participants and to give a brief overview of what the challenge or exercise contains and/or should teach/test.
Flow
This is where you edit the flow, see Flow for more information.
Run Code
The "Run Code" button will let you run your solution like you are a member taking the Freecode. You will see the output in the canvas and console just like if you were taking the Freecode as a member. If you check the "Save On Run" checkbox you will also save every time you run the code.
If you are creating a challenge or Code test you will see the text "run hidden levels" next to the "Run Code" button. If you check this you will also see the result for the hidden levels. This option is not available to members taking the Freecode.