Skip to content

Commit

Permalink
docs: Add readme documents
Browse files Browse the repository at this point in the history
  • Loading branch information
hv0905 committed May 17, 2022
1 parent 18052f0 commit 90a4069
Show file tree
Hide file tree
Showing 8 changed files with 111 additions and 0 deletions.
3 changes: 3 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -144,3 +144,6 @@ fabric.properties
# Android studio 3.1+ serialized cache file
.idea/caches/build_file_checksums.ser

# Visual Studio Project stuff

.vs/
17 changes: 17 additions & 0 deletions CMakeSettings.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
{
"configurations": [
{
"name": "x64-Debug",
"generator": "Ninja",
"configurationType": "Debug",
"inheritEnvironments": [
"msvc_x64_x64"
],
"buildRoot": "${projectDir}\\out\\build\\${name}",
"installRoot": "${projectDir}\\out\\install\\${name}",
"cmakeCommandArgs": "",
"buildCommandArgs": "",
"ctestCommandArgs": ""
}
]
}
87 changes: 87 additions & 0 deletions readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,87 @@
# HacknetOS

[![Build](https://github.com/hv0905/HacknetOS/actions/workflows/Build.yml/badge.svg)](https://github.com/hv0905/HacknetOS/actions/workflows/Build.yml)

A pure C++ command-line version of the original [Hacknet](https://hacknet-os.com) game.

[中文文档](readme_cn.md)

## ✨ Features

- Hacker game on pure C++ console
- UN*X like sandbox game environment.
- Unique ASCII-based hacking animation for every tool.

## ✈️ Try it

Download the newest build from the [Release](https://github.com/hv0905/HacknetOS/releases) page or from
our [continuous integration](https://github.com/hv0905/HacknetOS/actions/workflows/Build.yml).

Then execute `HacknetOS.exe` directly, we suggest run the game
on [Windows Terminal](https://apps.microsoft.com/store/detail/windows-terminal/9N0DX20HK701?hl=en-us&gl=US) for a better
experience.

You have to set the size of the console to at lease 220 x 50 characters to execute the game correctly. If your screen is
too small to display full of the game, consider reducing the font size or DPI scaling settings.

Currently, some part of the game supports Chinese only, the i18n is on the way, stay tuned!

## 📷 Screenshots

![title](web/screenshots/title.jpg)

![tutorial](web/screenshots/tutorial.jpg)

![crack](web/screenshots/crack.jpg)

![mailbox](web/screenshots/mailbox.jpg)

## 🪧 Future Plans

- Saving/Loading saves using JSON
- Isolated initial save
- More commands/ functions adapt to the original games
- multi-language/ i18n support
- cross-platform support

## 💻 Develop

This project is built by CMake. To build the project following the following steps:

1. Install necessary components: `Micorsoft Visual C++ buildtool`, `CMake`
2. Run the following command to build the project:

```shell
mkdir build && cd build # Create build dir
cmake .. # Initialize CMake project
cmake --build . # Build the project
```

We are strongly suggest using the following Code Editor to develop:

- CLion
- Visual Studio(With CMake workload)
- Visual Studio Code

## ❤ How to contribute

There are many ways to contribute to the project: logging bugs, submitting pull requests, reporting issues, and creating
suggestions.

Even if you have push rights on the repository, you should create a personal fork and create feature branches there when
you need them. This keeps the main repository clean, and your personal workflow cruft out of sight.

We're also interested in your feedback for the future of this project. You can submit a suggestion or feature request
through the issue tracker. To make this process more effective, we're asking that these include more information to help
define them more clearly.

## Special thanks

Scripts and ideas from: [Hacknet](https://hacknet-os.com)

Don't forget to try it if you like these type of games!

## Copyright

Copyright 2022 EdgeNeko
Licensed under GPL license.
4 changes: 4 additions & 0 deletions readme_cn.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
# HacknetOS

TODO

Binary file added web/screenshots/crack.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added web/screenshots/mailbox.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added web/screenshots/title.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added web/screenshots/tutorial.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 90a4069

Please sign in to comment.