https://github.com/makhuta/homeassistant-crafty_controller

Crafty Controller integration for HomeAssistant
https://github.com/makhuta/homeassistant-crafty_controller

crafty-controller homeassistant homeassistant-custom-component minecraft

Last synced: 5 months ago
JSON representation

Crafty Controller integration for HomeAssistant

• Host: GitHub
• URL: https://github.com/makhuta/homeassistant-crafty_controller
• Owner: Makhuta
• Created: 2024-07-23T16:52:28.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2024-09-15T16:26:16.000Z (almost 2 years ago)
• Last Synced: 2025-03-17T02:13:41.590Z (over 1 year ago)
• Topics: crafty-controller, homeassistant, homeassistant-custom-component, minecraft
• Language: Python
• Homepage:
• Size: 830 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# Data scrapper for Crafty Controller

Adds multiple sensors, button with information/statistics/functions grabbed from Crafty Controller account

## Installation

### Requirements:

1. Install this component by copying [these files](https://github.com/Makhuta/homeassistant-crafty_controller/tree/main/custom_components/crafty_controller) to `custom_components/crafty_controller/`.

2. **You will need to restart after installation for the component to start working.**

### Adding new device

To add the **Crafty Controller** integration to your Home Assistant, use this My button:



Manual configuration steps


If the above My button doesn’t work, you can also perform the following steps manually:

- Browse to your Home Assistant instance.

- Go to [Settings > Devices & Services](https://my.home-assistant.io/redirect/integrations/).

- In the bottom right corner, select the [Add Integration button.](https://my.home-assistant.io/redirect/config_flow_start?domain=crafty_controller)

- From the list, select **Crafty controller**.

- Follow the instructions on screen to complete the setup.

## Examples

### Installed device

![Instance](./imgs/instance.png)

This is the example of how succesfully installed Crafty integration should look like (there can be some differences in the number of devices/entities based on your *Crafty Controller* installation)

### All devices

![All devices](./imgs/devices.png)

At all time there will be at least 3 devices (All Roles, All Servers and All Users) and based on your Crafty installation there will be added another devices for each of them to provide nice UI.

### All roles

![All roles](./imgs/all_roles.png)

The Roles sensor will show the number of roles based on your specific settings and it will have connected the respective number of devices (roles) which will each have their own sensors

#### Examples for _testing role 1_

![Example role](./imgs/example_role.png)

##### Example of _Server access_

![Example role server access](./imgs/example_role_server_access.png)

Here you can see the number of servers **Role** has access to and the list of permissions for each server in sensor attributes.

##### Example of _Users_

![Example role users](./imgs/example_role_users.png)

This sensor shows the number of **Users** asigned to this role with list of users in its attributes.

### All users

![All users](./imgs/all_users.png)

The Users sensor will show the number of users your Crafty installation has (at least 1 should be there because you need the admin to log-in into the API)

#### Example for _admin_

![Example user](./imgs/example_user.png)

##### Example of _Roles_

![Example user roles](./imgs/example_user_roles.png)

In this part the integration will provide you with ability to see the number of roles the **User** has been assigned to and in attributes you can see the list of their names.

### All servers

![All Servers](./imgs/all_servers.png)

Here you are able to se 2 sensors:

1. **Servers Offline**: This will show the number of servers that are offline

2. **Servers Online**: This will obviously show the number of online servers

and next you can see that there are mentioned the servers that you have running (added) in Crafty Controller.

#### Example for _Majnr+_

![Example server](./imgs/example_server.png)

Here you can at the first glance see that there is some controlls, with these you are able to control the respective server based on the button name. Next you can see multiple statistics of the selected server.

## Note

If you spot any sort of bug, error or incostintency don't hesitate to open issue [here](https://github.com/Makhuta/homeassistant-crafty_controller/issues).