# Beginner's Guide to Lunaris

## Core Commands

One of the core commands, it allows you to manage and develop your space base.

The most basic usage is just simply:

```bash
l+base
```

Obviously, there is more to this command. You can upgrade buildings by adding "upgrade" as the first argument, and then the name of the building you want to upgrade.

```bash
l+base upgrade [building]
```

{% hint style="info" %}
The valid buildings are:

* headquarters
* bi (biomass injector)
* powerstation
* scanner
* laboratory
* shipyard

It is to be noted that this is an incomplete list, as the bot is still in development.
{% endhint %}

Another core command is: 

```bash
l+extract
```

Every 5 minutes, you can use this command to extract the asteroids that pass over your planet. This is the primary way of earning the necessary resources that are needed to upgrade your buildings. To view the resources you've collected, you can use the command:

```bash
l+library [Page Number]
```

The library is sorted into several pages. Each page contains one category of resources. The first page documents the basic building materials. This is probably the most important page. The second page documents the different hardware parts, which you will use to build shuttles and warships, more on that later. The third page documents the electronic components. You will use these to upgrade your spatial scanner, your laser drill, and manufacture electronic components for your shuttles and warships. The fourth page contains precious gemstones that you will occasionally dig out from the asteroids. You can invest these into a corporation, if you belong in one. The fifth page contains exotic antiques. Not much is known about them, other than that they are from a time long forgotten.

## Cash Caches

Cash caches are extra special, so we'll dedicate an entire section on the beginner's guide just for it. Cash caches are crates that contain lots of valuable resources. You earn credits, gravity stones, and XP when you open one. The "appearance" of one of them depends on the global timer. When that timer reaches 0, a cash cache can be claimed. Keep in mind, however, that this is a global event, and there is only one cash cache. Whoever sends the command first when the timer reaches 0 will win the cash cache. Everyone else will have to wait for the next chance to snag one.

```bash
l+cashcache or l+cc
```

{% hint style="info" %}
Protip: The chances of winning the cash cache are higher if you spam the command when it nears zero. However, if you spam too early, Discord will rate limit you, and your messages won't get received by the bot until after someone has probably already caught it.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://lunaris.gitbook.io/lunaris/beginners-guide/untitled.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.