Skip to content

Commit 57b4824

Browse files
mittonkmittonk
authored
DICE docs v1 (#1026)
* DICE core docs. * Refining DICE. * Refining DICE. * Refining DICE.
1 parent c2531a8 commit 57b4824

File tree

5 files changed

+202
-0
lines changed

5 files changed

+202
-0
lines changed

‎docs/development/licenses.md

+1
Original file line numberDiff line numberDiff line change
@@ -90,6 +90,7 @@ See below for a summary of the licenses behind RetroArch and its cores:
9090
| [CrocoDS](../library/crocods.md) | [MIT](https://github.com/libretro/libretro-crocods/blob/master/LICENSE) | |
9191
| [DeSmuME 2015](../library/desmume_2015.md) | [GPLv2](https://github.com/libretro/desmume2015/blob/master/desmume/COPYING) | |
9292
| [DeSmuME](../library/desmume.md) | [GPLv2](https://github.com/TASVideos/desmume/blob/master/license.txt) | |
93+
| [DICE](../library/dice.md) | [GPLv3](https://github.com/mittonk/dice-libretro/blob/master/LICENSE.txt) | |
9394
| [Dinothawr](../library/dinothawr.md) | [Non-commercial](https://github.com/libretro/Dinothawr/blob/master/LICENSE) | Non-commercial |
9495
| Dolphin | [GPLv2](https://github.com/dolphin-emu/dolphin/blob/master/license.txt) | |
9596
| DOSBox | [GPLv2](https://github.com/libretro/dosbox-libretro/blob/master/COPYING) | |

‎docs/guides/core-list.md

+1
Original file line numberDiff line numberDiff line change
@@ -50,6 +50,7 @@
5050
| Daphne | Arcade | |
5151
| DeSmuME | Nintendo DS | |
5252
| DeSmuME 2015 | Nintendo DS | |
53+
| DICE | Arcade | Pre-CPU games like Pong |
5354
| Dinothawr | Game engine | A push-the-block-in-a-straight-line puzzle game in the spirit of Kickle Cubicle |
5455
| DirectXbox | Xbox | |
5556
| Dolphin | Nintendo GameCube/Wii | |

‎docs/library/dice.md

+198
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,198 @@
1+
# DICE
2+
3+
## Background
4+
5+
DICE is a Discrete Integrated Circuit Emulator. It emulates computer systems
6+
that lack any type of CPU, consisting only of discrete logic components.
7+
8+
dice-libretro is a Libretro port of DICE, to run in RetroArch.
9+
10+
11+
The DICE core has been authored by:
12+
13+
- Adam B & DICE Team (Standalone DICE)
14+
- Ken Mitton
15+
16+
The DICE core is licensed under:
17+
18+
- [GPLv3](https://github.com/mittonk/dice-libretro/blob/main/LICENSE.txt)
19+
20+
A summary of the licenses behind RetroArch and its cores can be found [here](../development/licenses.md).
21+
22+
## Requirements
23+
24+
Minimal.
25+
26+
## How to start the DICE core:
27+
28+
Some games use zipped ROMs and launch similarly to MAME or FBNeo --- filename is
29+
important, see table at
30+
https://github.com/mittonk/dice-libretro/?tab=readme-ov-file#usage
31+
32+
Please do not attempt to contact the DICE team to request ROM files.
33+
34+
Some games (pong, breakout, pinpong, etc) do not have any ROM on the board at
35+
all. For these, copy the dummy launcher file from
36+
[dummy_files](https://github.com/mittonk/dice-libretro/tree/main/dummy_files)
37+
to your ROM
38+
folder; these have a correct name (for example, pong.dmy) that will get
39+
RetroArch to set up lr-dice for the correct game.
40+
41+
## BIOS
42+
43+
None.
44+
45+
## Extensions
46+
47+
Content that can be loaded by the DICE core have the following file extensions:
48+
49+
- .zip
50+
- .dmy
51+
52+
.dmy files are used for games without any ROM component, see "How to start the
53+
DICE core" above.
54+
55+
RetroArch database(s) that are associated with the DICE core:
56+
None yet.
57+
58+
## Features
59+
60+
Frontend-level settings or features that the DICE core respects:
61+
62+
| Feature | Supported |
63+
|-------------------|:---------:|
64+
| Restart | ✔ |
65+
| Saves | ✕ |
66+
| States | ✕ |
67+
| Rewind | ✕ |
68+
| Netplay | ✕ |
69+
| Core Options | ✔ |
70+
| RetroAchievements | ✕ |
71+
| RetroArch Cheats | ✕ |
72+
| Native Cheats | ✕ |
73+
| Controls | ✔ |
74+
| Remapping | ✔ |
75+
| Multi-Mouse | ✔ |
76+
| Rumble | ✕ |
77+
| Sensors | ✕ |
78+
| Camera | ✕ |
79+
| Location | ✕ |
80+
| Subsystem | ✕ |
81+
| [Softpatching](../guides/softpatching.md) | ✕ |
82+
| Disk Control | ✕ |
83+
| Username | ✕ |
84+
| Language | ✕ |
85+
| Crop Overscan | ✕ |
86+
| LEDs | ✕ |
87+
88+
## Directories
89+
90+
None.
91+
92+
## Geometry and timing
93+
94+
Varies based on individual game, mostly around 640x246, 60 FPS.
95+
96+
## Usage
97+
98+
Again, see .dmy files for games that do not use read-only memory.
99+
100+
## Core options
101+
102+
There are numerous options around using mice to simulate spinners / paddle
103+
controllers, see
104+
https://github.com/mittonk/dice-libretro/?tab=readme-ov-file#mouse-support .
105+
106+
These are still in flux.
107+
108+
## User 1 device types
109+
110+
The DICE core supports the following device type(s) in the controls menu, bolded device types are the default for the specified user(s):
111+
112+
- **RetroPad**
113+
- RetroPad w/Analog
114+
- Mouse
115+
116+
## Joypad
117+
118+
Most games are playable with just a joypad. Controls vary by game.
119+
120+
| RetroPad Inputs | User # input descriptors | (Device name) Inputs |
121+
|------------------------------------------------|--------------------------|---------------------------|
122+
| ![](../image/retropad/retro_b.png) | Button 2 | - |
123+
| ![](../image/retropad/retro_y.png) | Button 3 | - |
124+
| ![](../image/retropad/retro_select.png) | Coin | - |
125+
| ![](../image/retropad/retro_start.png) | Start | - |
126+
| ![](../image/retropad/retro_dpad_up.png) | Up | - |
127+
| ![](../image/retropad/retro_dpad_down.png) | Down | - |
128+
| ![](../image/retropad/retro_dpad_left.png) | Left | - |
129+
| ![](../image/retropad/retro_dpad_right.png) | Right | - |
130+
| ![](../image/retropad/retro_a.png) | Button 1 | - |
131+
| ![](../image/retropad/retro_x.png) | | - |
132+
| ![](../image/retropad/retro_l1.png) | Dollar | - |
133+
| ![](../image/retropad/retro_r1.png) | | - |
134+
| ![](../image/retropad/retro_l2.png) | | - |
135+
| ![](../image/retropad/retro_r2.png) | | - |
136+
| ![](../image/retropad/retro_l3.png) | | - |
137+
| ![](../image/retropad/retro_r3.png) | | - |
138+
| ![](../image/retropad/retro_left_stick.png) X | Paddle | - |
139+
| ![](../image/retropad/retro_left_stick.png) Y | Paddle | - |
140+
| ![](../image/retropad/retro_right_stick.png) X | | - |
141+
| ![](../image/retropad/retro_right_stick.png) Y | | - |
142+
143+
## Mouse
144+
145+
| RetroMouse Inputs | (Device name) Inputs |
146+
|-------------------------------------------------------|---------------------------|
147+
| ![](../image/retromouse/retro_mouse.png) Mouse Cursor | Paddle, see https://github.com/mittonk/dice-libretro/?tab=readme-ov-file#mouse-support |
148+
| ![](../image/retromouse/retro_left.png) Mouse 1 | - |
149+
| ![](../image/retromouse/retro_right.png) Mouse 2 | - |
150+
| ![](../image/retromouse/retro_middle.png) Mouse 3 | - |
151+
| Mouse 4 | - |
152+
| Mouse 5 | - |
153+
| Wheel Up | - |
154+
| Wheel Down | - |
155+
| Wheel Left | - |
156+
| Wheel Right | - |
157+
158+
## Compatibility
159+
160+
| Name | Base filename | Publisher | Year | Needs ROM? |
161+
| ---- | ------------- | --------- | ---- | -------- |
162+
| Anti-Aircraft | antiaircraft | Atari | 1975 | x |
163+
| Attack | attack | Exidy | 1977 | x |
164+
| Breakout | breakout | Atari | 1976 | |
165+
| Clean Sweep | cleansweep | Ramtek | 1974 | x |
166+
| Crash 'N Score | crashnscore | Atari | 1975 | x |
167+
| Crossfire | crossfire | Atari | 1975 | |
168+
| Gotcha | gotcha | Atari | 1973 | |
169+
| Hi-Way | hiway | Atari | 1975 | |
170+
| Indy 4 | indy4 | Atari | 1976 | x |
171+
| Jet Fighter | jetfighter | Atari | 1975 | x |
172+
| Pin Pong | pinpong | Atari | 1974 | |
173+
| Pong | pong | Atari | 1972 | |
174+
| Pong Doubles | pongdoubles | Atari | 1973 | |
175+
| Quadrapong | quadrapong | Atari | 1974 | |
176+
| Rebound | rebound | Atari | 1974 | |
177+
| Shark Jaws | sharkjaws | Atari | 1975 | x |
178+
| Space Race | spacerace | Atari | 1973 | |
179+
| Steeplechase | steeplechase | Atari | 1975 | x |
180+
| Stunt Cycle | stuntcycle | Atari | 1976 | x |
181+
| TV Basketball | tvbasketball | Midway | 1974 | |
182+
| Wipe Out | wipeout | Ramtek | 1974 | x |
183+
184+
185+
## External Links
186+
187+
- [Original DICE Website](https://adamulation.blogspot.com/) (inactive)
188+
- [Original DICE Repository](https://sourceforge.net/projects/dice/) (inactive)
189+
- [DirtBagXon's DICE Repository](https://github.com/DirtBagXon/DICE)
190+
- [Libretro DICE Core info file](https://github.com/libretro/libretro-super/blob/master/dist/info/dice.info)
191+
- [Libretro DICE (Website name)
192+
Repository](https://github.com/mittonk/dice-libretro)
193+
- [Report Libretro DICE Core Issues
194+
Here](https://github.com/mittonk/dice-libretro/issues)
195+
196+
## (Related cores)
197+
198+
MAME has some overlap (Pong, for example).

‎docs/meta/see-also.md

+1
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,7 @@ This is a list of cores that are related to each other in some way.
1313

1414
## Arcade
1515

16+
- [DICE](../library/dice.md)
1617
- [MAME 2003](../library/mame_2003.md)
1718
- [MAME 2003-Plus](../library/mame2003_plus.md)
1819
- [MAME 2010](../library/mame_2010.md)

‎mkdocs.yml

+1
Original file line numberDiff line numberDiff line change
@@ -117,6 +117,7 @@ nav:
117117
- 'Apple':
118118
- 'Apple - Macintosh (minivmac)': 'library/minivmac.md'
119119
- 'Arcade Emulation':
120+
- 'Arcade (DICE)': 'library/dice.md'
120121
- 'Arcade (FinalBurn Neo)': 'library/fbneo.md'
121122
- 'Arcade (MAME 2003)': 'library/mame_2003.md'
122123
- 'Arcade (MAME 2003-Plus)': 'library/mame2003_plus.md'

0 commit comments

Comments
 (0)