# super-coding-ball

**Repository Path**: mirrors_Orange-OpenSource/super-coding-ball

## Basic Information

- **Project Name**: super-coding-ball
- **Description**: SuperCodingBall is a free educational game, which aims to introduce programming, through the theme of football (soccer)!
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-07-16
- **Last Updated**: 2026-02-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SuperCodingBall
![icon](./src/assets/app-icons/SuperCodingBallAppIcon.svg)

*Lire en [français](README.fr.md).*

SuperCodingBall is a free educational game for 10+ years old children.

The goal is to discover programming with a football game! (it is a great way for teachers to introduce programming concepts)

The programming is done visually, like in [Scratch](https://scratch.mit.edu), but with fewer blocks (there is for example no "loops").

The player will train a team of 4 footballers who will face 4 monsters.

The team's strategy is built with blocks, then the game takes place automatically following the strategies of the two teams.

![screenshot](./src/assets/howto/screenshot.png)

# Mobile

SuperCodingBall can be played on mobile, tablet or computer (in this case, the blocks are displayed next to the football field).

On an Android or iOS device, one can install the application as [PWA](https://web.dev/progressive-web-apps) (it allows to play even without connection).

# Offline vs online

There are two game modes:
* local play, against the computer (with some pre-defined strategies)
* online play, against other players (requires internet connection)

For online play, SuperCodingBall uses the [Webcom service](https://datasync.orange.com) to store player information.
This is a service reserved for [Orange](https://www.orange.com) developers, but it can be easily replaced by any other "Backend As a Service" (like Firebase).

There are 3 options to connect:
* As a guest (does not allow using multiple devices)
* With a Facebook account
* With a Google account

In all cases, SuperCodingBall will store the (modifiable) nickname, the blocks and the results of the games played.

At any time, players can delete their account.

# Blockly

SuperCodingBall uses the excellent [Blockly](https://www.blockly.com) library to manage interactions with blocks.

To generate the personalized blocks, you can use the [Blockly Developer Tools](https://blockly-demo.appspot.com/static/demos/blockfactory/index.html), the source of the blocks being stored [here](./src/assets/blocks/library.xml).

Once the [blocks.json file](./src/assets/blocks/blocks.json) has been generated, it must be modified to add styles, extensions and translations.

# Sprites creation

All player sprites come from the "Open Game Art Liberated Pixel Cup" and were generated by [this tool](https://github.com/LiberatedPixelCup/Universal-LPC-Spritesheet-Character-Generator):
* [Guy 1](https://liberatedpixelcup.github.io/Universal-LPC-Spritesheet-Character-Generator/#?body=Body_color_amber&head=Human_male_amber&shoes=Basic_Shoes_brown&legs=Pants_red&hair=Messy1_blonde&sex=male&clothes=Sleeveless_2_navy&expression=Neutral_amber&eye_color=Eye_Color_blue)
* [Guy 2](https://liberatedpixelcup.github.io/Universal-LPC-Spritesheet-Character-Generator/#?body=Body_color_black&head=Human_male_black&shoes=Basic_Shoes_charcoal&legs=Pants_red&hair=Cornrows_green&sex=male&clothes=Sleeveless_2_Buttoned_blue&expression=Neutral_black&eye_color=Eye_Color_brown)
* [Girl 1](https://liberatedpixelcup.github.io/Universal-LPC-Spritesheet-Character-Generator/#?body=Body_color_brown&head=Human_female_brown&shoes=Basic_Shoes_brown&legs=Pants_red&hair=Ponytail2_black&sex=female&clothes=Original_Sleeveless_blue&expression=Neutral_brown&eye_color=Eye_Color_brown)
* [Girl 2](https://liberatedpixelcup.github.io/Universal-LPC-Spritesheet-Character-Generator/#?body=Body_color_light&head=Human_female_light&shoes=Basic_Shoes_brown&legs=Pants_red&hair=Long_tied_purple&sex=female&clothes=Scoop_lavender&expression=Neutral_light&eye_color=Eye_Color_purple)
* [Orc](https://liberatedpixelcup.github.io/Universal-LPC-Spritesheet-Character-Generator/#?body=Body_color_green&head=Orc_male_green&legs=Long_Pants_black)
* [Lizard](https://liberatedpixelcup.github.io/Universal-LPC-Spritesheet-Character-Generator/#?body=Body_color_bright_green&head=Lizard_male_bright_green&legs=Long_Pants_black&wings=Lizard_Wings_bright_green&tail=Lizard_tail_bright_green)
* [Wolf](https://liberatedpixelcup.github.io/Universal-LPC-Spritesheet-Character-Generator/#?body=Body_color_pale_green&head=Wolf_male_pale_green&legs=Long_Pants_black&tail=Wolf_Tail_raven)
* [Zombie](https://liberatedpixelcup.github.io/Universal-LPC-Spritesheet-Character-Generator/#?body=Body_color_zombie_green&head=Zombie_zombie_green&legs=Long_Pants_black&overalls=Overalls_black)

# Translations (for now English, French, Spanish, Russian, Hebrew, German, Arabic, Dutch, Japanese, Korean and Chinese)

All translations are in the [i18n folder](./src/assets/i18n).

Feel free to contribute if you want to add another language!

# Genesis
SuperCodingBall has been created during an internal competition, but it is fully free, open source and without any ads.