Skip to the content
2 layers81 × 98 mmLuna, the printed circuit board in 3D

my second project for fallout

Size
81 × 98 mm
Copper layers
2
Thickness
1.6 mm
Parts
8
Nets
14
Pads
61
Tracks, vias
135, 20
Routed
Yes
KiCad
KiCad 9.0 (file 20241229)
Created
15 Apr 2026
Updated
3 May 2026

Overview

Luna is an open-source printed circuit board by robertshepherdcpp, from the robertshepherdcpp/tamagotchi repository on GitHub. It is a 2-layer board of 81 × 98 mm with 8 parts on 14 nets, routed with 135 tracks and 20 vias.

It is built around the HS96L03W2C03 and 1207-P6.5MM. Its parts include 5 switches and 2 ICs. It belongs with the ESP32 and RISC-V boards of this library.

Main components

2

README

README.md

tamagotchi

luna-tamagotchi my second project for fallout

what the project is:

  • a custom tamagotchi consisting of a pcb designed in kiad and a case designed in the CAD software Fusion360 what the tamagotchi consists of:
    • a 3d case + lid
    • the pcb which consists of: XIAO-ESP32-C6, buzzer, rotary encoder, 4 buttons, and a 0.96" screen.

why i chose to make with project (the inspiration/motivation):

  • as i am still new to hardware, i thought having a tutorial as a fallback for if i got stuck would be useful (avoid endless rabbit holes hhh). also i remember using a tamagotchi when i was younger and thought it was pretty cool
  • so i decided to make a tamagotchi but to personalize it, so i made it of my friend luna.
  • therefore as the firmware i planned to make it have many of the same interests/personality traits as my friend
  • my mum had one of these when she was younger, and I thought it would be cool to make my own version and show it to her.

how to use my project

  • first print off etc. the pcb and case. many different providers to do this.
  • then to load the firmware (found in this respository), you can:
text
download the arduino IDE, install all the relevant libraries: Adafruit SSD1306 (by Adafruit), Adafruit GFX Library (by Adafruit). then
load up the xiao-esp32-c6 board. plug the project into your computer via usb, and press port on the arduino guide. as this project doesnt have a battery built
in, in order for this project to work it has to have a usb connected to it at all times.
for more help you can refer to these two guides:
https://fallout.hackclub.com/docs/guided-projects/tamagotchi-firmware
https://wiki.seeedstudio.com/xiao_esp32c6_getting_started/

how the project works

  • the project is mainly just a tamogatchi with a few little changes.
  • the pet has different characteristics, hunger, happiness, energy, age, intelligence
  • there are 4 main states: nap [SJ], feed luosifen [LSF], climb a mountain [CLMB], wildcard [WLDCRD].
  • nap: energy increases by 15 points, intelligence increases by 10 points.
  • feed: hunger increases by 10 points (means it is getting less hungry), energy increases by 5 points
  • play: happiness increases by 10 points, energy decreases by 5 points
  • wildcard: this is where the rotary encoder comes into play, you select a random orientation on the tamogotchi which corresponds to a number 0-19 inclusive. a random number is then selected, if you pick that number, the one below it or above it, the pets happiness is doubled! however if you dont guess correctly, its decreased by 15%!! are you willing to risk your pets happiness?
  • all values apart from age are capped in the ranges 1 to 100.
  • the aim to get all values as high as possible.
  • this is all done behind the scenes with the pcb, controlled by the XIAO-ESP32-C6.

how to use it?

  • after setting up the project (with the PCB and Case etc. all set up):
  • this tamagotchi is your pet, you can feed it (luosifen), let it play (climb mountains), let it take a nap, and you can also go to a section called the wildcard
  • this is where you pick a random number between 1 and 18 and if you get the number or one of the adjacent numbers, your pets happiness doubles! however if not the happiness is decreased by 15%.
  • your ultimate goal is to keep your pet happy, healthy etc. by keeping the 4 stats variables high (intelligence, hunger, energy and happiness)

here are some images of the project:

image image image (there are a few components missing in this image because the STEP files for them didnt load, however shouldnt have any effect when it comes to the actual PCB fabrication.) image image

estimated costs (via uploading gerber files to jlcpcb): image link

my zine: image

The BOM (available in BOM.csv in this github repo): aliexpress link image Total Cost: $27.44

the whole building process was documented on my youtube channel here

Parts

8
QtyValueFootprintReferences
4SW_PushButton_Switch_SMD:SW_Push_1P1T_NO_CK_KSC6xxGSW1, SW2, SW3, SW4
11207-P6.5MMeasyeda2kicad:BUZ-TH_BD12.5-P6.50-D1.4BUZZER1
1HS96L03W2C03easyeda2kicad:OLED-TH_L27.8-W27.2-P2.54_C9900033791U2
1RotaryEncoderRotary_Encoder:RotaryEncoder_Alps_EC11E-Switch_Vertical_H20mmSW5
1XIAO-ESP32-C6-DIPSeeed Studio XIAO Series Library:XIAO-ESP32-C6-DIPU1

Similar boards

  • 2 layers56.8 × 66.2 mmTamagotchi, the printed circuit board in 3D

    Tamagotchi

    TaniWanKenobi/tamagotchi

    A custom PCB-based Tamagotchi virtual pet built with the XIAO-ESP32-C6!

    14 parts5
  • 2 layers50 × 75 mmVideocraft PetPad, the printed circuit board in 3D

    Videocraft PetPad

    Videocraft10/PetPad

    Custom Made Tamagotchi Like Device

    13 parts2MIT
  • 2 layers70.6 × 76 mmTamagotchi, the printed circuit board in 3D

    Tamagotchi

    Er1n-jpg/Psyduck-gotchi

    Tamagotchi project made for fallout

    11 parts1
  • 2 layers64.3 × 76.8 mmTamagotchi, the printed circuit board in 3D

    Tamagotchi

    shelxty/lego-tamagotchi

    Simple tamagotchi with OLED display screen, buzzer, and 3 buttons custom-made in KiCad, with parts assembled in OnShape.

    10 parts1
  • 2 layersReleastic tamagotchi, the printed circuit board in 3D

    Releastic tamagotchi

    alex-technologia/Realistic-tamagochi

    A tamagochi but much more realistically accurate

    10 parts
  • 2 layers74.4 × 97.8 mmTamagotchi, the printed circuit board in 3D

    Tamagotchi

    Ayush09S/Tamagotchi

    A small digital pet as a physical device remake! It features an LDR that can detect light changes, four buttons, and a buzzer. It also has an OLED display!

    16 partsMIT
  • 2 layers95.6 × 69.3 mmFallout pcb, the printed circuit board in 3D

    Fallout pcb

    Er1n-jpg/Fallout-pcb

    12 parts
  • 2 layers74.8 × 74.1 mmTamagotchi, the printed circuit board in 3D

    Tamagotchi

    hiralsinghal/Tamagotchi

    This is a Tamagotchi. It is a small handheld video game in which you have a pet. You can play with it, feed it and more depending on your firmware code.

    10 partsMIT

Questions

How big is the Luna PCB?

It measures 81 × 98 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Luna use?

8 parts, built around the HS96L03W2C03 and 1207-P6.5MM. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.

Where can I download the Luna KiCad files?

From the robertshepherdcpp/tamagotchi repository on GitHub, at the commit this page was made from: the board is PCB/luna.kicad_pcb and its schematic PCB/luna.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Luna design in my own project?

Its repository states no licence, so its author keeps all rights: ask robertshepherdcpp before reusing the design.