CloverOS - User Manual
--------------------------------

Welcome to **CloverOS**, a ComputerCraft-based operating system designed to simulate a fully functional, user-friendly environment akin to real-world operating systems. Below are the instructions to help you set up, navigate, and use your new system.

### Table of Contents
1. Introduction
2. System Requirements
3. Installation
4. Running CloverOS
5. Navigating the OS
6. Available Apps
7. Troubleshooting
8. Advanced Features

---

### 1. Introduction

CloverOS is an immersive operating system for the ComputerCraft mod within Minecraft. It includes various utilities and applications to simulate a complete computing experience. With support for games, file management, and a command terminal, CloverOS offers a range of features to enhance your in-game experience.

---

### 2. System Requirements

To use **CloverOS**, your system must meet the following requirements:
- **Minecraft** with the **ComputerCraft** mod (or **CC:Tweaked** mod) installed.
- **1GB of available memory** on the computer for optimal performance.
- A **floppy disk** with the **CloverOS** files installed.

---

### 3. Installation

1. **Prepare the Floppy Disk**:
   - Insert your floppy disk into the **disk drive**.
   - Ensure that **CloverOS** is installed on the disk, including the following files:
     - `CloverOS_OS.lua` (the core OS file)
     - `instructions.txt` (this file)
     - Any apps or utilities you wish to run from the OS.
   
2. **Insert the Floppy Disk** into a ComputerCraft computer in the game.

---

### 4. Running CloverOS

To launch **CloverOS**:
1. Open the **ComputerCraft Terminal**.
2. Type the following command to start the operating system:

shell.run("disk/CloverOS_OS.lua")

markdown
Kopiëren
Bewerken

3. After a short loading period, the operating system will boot up, and you will be greeted with the main interface.

---

### 5. Navigating the OS

Once **CloverOS** is running, you can navigate the environment through the following elements:

- **Login Screen**: To begin, you will be prompted to enter your username and password. Default credentials are:
 - Username: `user`
 - Password: `pass`

If you are a new user, you can modify or add additional user credentials by editing the `users` array in the `CloverOS_OS.lua` file.

 - **Main Menu**: The main menu shows a list of available applications, such as:
 - **Clock App**: Displays the current time.
 - **Windows CMD**: Lets you interact with the terminal and input commands.
 - **File system**: Allows you to create and edit files.

Use the arrow keys to navigate the menu, and press **Enter** to launch an application.

---

### 6. Available Apps

The following apps are included in **CloverOS**:

- **Clock App**: A simple clock that updates in real-time and displays the current system time.
- **Windows CMD**: An interactive terminal where you can type commands. Type `exit` to return to the main menu.
- **Music Player**: A simple game where you control a snake to collect food and avoid collisions.
- **File System**: Create and edit files for various purposes. You can save your work and access it later.

More apps can be added by placing `.lua` files in the `apps` directory, same goes for commands but in 'bin' directory and only '.lua','.exe','.dll' are accepted and NO you cant use actual exe files or .ddl files as they must contain lua code.

---

### 7. Troubleshooting

If you encounter issues with **CloverOS**, consider the following solutions:

- **Floppy Disk Not Detected**:
 - Ensure that the floppy disk is inserted into the correct drive (`disk`).
 - Verify that the disk contains the correct files (`CloverOS_OS.lua`, `instructions.txt`, and the apps folder).

- **System Freezes**:
 - Try pressing **Ctrl + T** to reset the terminal and return to the main menu.
 - If the system is unresponsive, restart the ComputerCraft computer.

---

### 8. Advanced Features

**CloverOS** includes a range of advanced features for power users:

- **File Management**: You can interact with the file system using built-in commands such as `ls`, `cd`, and `cat`. Use `shell.run()` to execute scripts from the terminal.
- **User Management**: Add new users by modifying the `users` array in the `CloverOS_OS.lua` file. Each user can have their own credentials.
- **Custom Apps**: You can create custom apps by writing Lua scripts and placing them in the `apps` directory. These can be run from the main menu.

---

### Conclusion

Thank you for choosing **CloverOS**! We hope you enjoy using the system. Whether you're exploring the pre-installed applications or creating your own custom tools, there's plenty to explore and experiment with.

For more advanced tutorials, future updates, or assistance, feel free to reach out to the CloverOS community.

Happy computing!