https://github.com/kostyabet/15puzzle-fasm
15 PUZZLE game was done on FASM in real processor mode under MS-DOS.
https://github.com/kostyabet/15puzzle-fasm
15-puzzle fasm ms-dos
Last synced: 2 months ago
JSON representation
15 PUZZLE game was done on FASM in real processor mode under MS-DOS.
- Host: GitHub
- URL: https://github.com/kostyabet/15puzzle-fasm
- Owner: kostyabet
- Created: 2024-05-30T08:56:31.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-08-17T12:18:56.000Z (about 1 year ago)
- Last Synced: 2024-12-10T19:50:15.959Z (10 months ago)
- Topics: 15-puzzle, fasm, ms-dos
- Language: C
- Homepage:
- Size: 13.7 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 15 PUZZLE
Flat assembler 15 PUZZLE game for MS-DOS.
## Content
- [Download](#download)
- [Using](#using)
- [Project structure](#project-structure)
- [Code Refactoring](#code-refactoring)
- [Gratitude](#gratitude)
## Download
You can use last release version for playing in puzzle.
| ⚠️ **Attention** |
|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| This project was done on FASM in `real processor mode` under `MS-DOS`. Since there was no page addressing before, the executable file of the program will not run on modern operating systems `Windows 8, 10, 11.` |
The executable file has the format `*.com` format and any com file executor under Windows is required to run it.
You can use `DOSBox`.
1. Install `DOSBox` on your computer. Use this link.
2. Install `*.com` file from release.
## Using
1. Place the `DOSBox` executable file and the `*.com` executable file in the same directory.
2. Left-click the `*.com` file and drag it onto the `DOSBox` executable.
3. Play!!!
## Project Structure
```plaintext
├── Units
│ ├── System / Sound / Random / Mouse / Game # System - main blocks code
│ │ │ # Sound - all sounds code
│ │ ├── *.c # Source code # Random - random functions
│ │ ├── *.di # Data initialized # Mouse - mouse functions
│ │ ├── *.du # Data uninitialized # Game - game alghoritms
│ │ └── *.h # Includes / macros
│ │
│ └── Draw # All frontend
│ │
│ ├── Digits / Fonts / Letters # Digits - all digits drawing
│ │ │ # Fonts - main screens drawing
│ │ ├── *.c # Source code # Letters - all EN Alphabet drawing
│ │ ├── *.di # Data initialized
│ │ ├── *.du # Data uninitialized
│ │ └── *.h # Includes / macros
│ │
│ ├── Color.di # Data initialized
│ └── Draw.h # Includes / macros
│
└── Tag.asm # The executable file of the project
```
## Code Refactoring
If you want to refactor the code, then you can use several possible tools. But to implement any of them, you need a FASM compiler.
1. Install FASM on your computer by this link.
2. Copy `proc16.inc` on the following path `~\FASM\INCLUDE\MACRO`.
- `proc16.inc` - macro file for fasm. This file includes the ability to create local parameters in routines and use calling conventions.
3. Open `FASMW.exe` and you can start coding.
But if you won't write code more comfortable you can use `FASM Editor 2.0`.
4. Install `FASM Editor 2.0` by this link.
5. Start `FEditor.exe`.
6. First of all go `Services\Settings`.
- FASM: put way to `FASM.exe`;
- INC: put way to `INCLUDE` folder;
- DBG: put way to `*.exe` debugger.
### Debugger
You can use `Olly Dbg`. Install by this link.
## Gratitude
### If you liked this project, please put a star on this repository!!!