tinycircuits/tinycircuits-thumby-games

TinyCircuits-Thumby-Games

Repository of TinyCircuits and community made Thumby games.

Games that live here can be seen in the web IDE (https://code.thumby.us/) using arcade (click "Arcade" in the top bar).

Games can be downloaded directly to Thumby from the Arcade or opened in the IDE editors.

Getting your game ready for the Arcade

Extended documentation of below directions with pictures available here from the Thumby Docs site: https://thumby.us/

• Some files in your game directory need to have a certain name and location
  • A Python file with the same name as the game root directory is required. For example, if a game is called TinyBlocks then the main game source file needs to be called TinyBlocks.py, this ensures the game shows up on the Thumby start screen
  • Two extra files are required for your game to show up on the arcade and should be located in the root of your game directory
    • A .png (image) or .webm (video) of gameplay. The filename does not matter, but arcade_title_video.webm or arcade_title_image.png is preferred. A file extension is required. If both files are present, the .webm will be used instead of the .png for display in the web IDE arcade. Please keep image and video resolution between anything from 8x (576x320px) to 16x (1152x640px).
    • A description file named exactly arcade_description.txt. Markdown files will not work. This description is displayed when a user hovers over the game in the Arcade.

Below is an example of how a game should be structured:

TinyBlocks
    - arcade_description.txt
    - arcade_title_video.webm
    - TinyBlocks.py

NOTE: Other files and directories are allowed in your game, the above shows the required items and locations.

Getting your game on the Arcade

1. Submit a pull request to this repository with your game directory added (GitHub making a pull request)
2. Wait for TinyCircuits to review and accept the PR
3. Wait for the URL builder GitHub action to build the new URL list (should take minutes)
4. Access the web IDE and click the "Arcade" button to view and find you game (at this point if you can see it, anyone else can as well)
5. Refresh the arcade using F5 for the page or using the arcade refresh button if you do not see your game

Editing or removing your game from the Arcade

The same process as adding a game, just submit a pull request with the edits.

tinycircuits-thumby-games's Issues

Update `Thumgeon` button code to use API

As a 'core' game, Thumgeon should use the Thumby API where possible; in part for best practice/ education.
The custom button handling code should be replaced with API equivalents.
This also avoids the extra import of Pin from machine.

Lack of licenses for games

I don't know if it is the right place to talk about that. Sorry if it's not.
We don't know with which license the games we can propose on this project are released. I guess it doesn't matter for almost all games but I developped a game with assets that are not mine. I asked the owner the permission and he agrees I release the game somewhere but I'd like to tell him the license before I do so...

'Battery' contains errors

From debugging Thumby core files, 'Battery' app contains at least these issue:

• Triggers an ImportError late in the running of the program!?
• Doesn't have an EOF guard of thumby.reset().

🌶Spice Warning / Hot take !🌶
There should be some minimal QA on software provided in this 'App Store'... just not sure how!

Some bugs I found within the stock games on my newly recieved thumby

I have no idea if the is the right place to report issues with the stock games on the thumby but it seems kinda fitting here. If not, I am sorry.

I was so lucky to receive one of the 50 early bird units of the thumby and I found some bugs within the pre-installed games (MicroPython v1.17 on 2021-09-02):

SpaceDebris:
when I destroy the last comet the game freezes and i have to make a hard reset. No finish screen whatsoever.

Thumgeon (my favorite game for the thumby so far despite game breaking bugs):

• sometimes it can happen that a dialogue object gets spawned in font of a door which can make further progress impossible (or are those riddles I have to solve before I can proceed?)
• pressing left (on the d-pad) within the inventory (to select the drop action i guess) freezes the game and a hard reset has to be performed
• any interaction with the a shop will cause the game to freeze and I have to perform a hard reset

Requested screenshot for TinyMonsters

Here:
Also, when do you plan to ship the light gray thumbys?

Tiny_Monster_Hunter does not start on Thumby

As the title says: the game does not start on the thumby and freezes. This is what is printed to the console when tested with thumby plugged in and in debug mode:

Traceback (most recent call last):
  File "main.py", line 17, in <module>
MemoryError: memory allocation failed, allocating 3154 bytes

Tiny Rogue only loading to title screen?

I can't seem to get passed the title screen.
It just seems like it's frozen, but I did confirm that it is looping through the title screen, inputs just aren't doing anything. ¯\_ (ツ)_/¯

Micro Square root Calc is not in a folder and causes the game not to be added to code.thumby.us

Hi there I noticed that a recently added game called "Micro Square Root Calc" was not merged correctly into the main tiny circuits repository. To fix this you can add a folder called "Micro Square Root Calc" and delete the old files and it will all be fixed.