Skip to content

Commit b7f7bd4

Browse files
committed
Add it-crafting v1
1 parent b8d81cb commit b7f7bd4

File tree

10 files changed

+1761
-0
lines changed

10 files changed

+1761
-0
lines changed

pages/_meta.json

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -30,6 +30,12 @@
3030
"theme": {
3131
"footer": false
3232
}
33+
},
34+
"it-crafting": {
35+
"title": "🛠️・it-crafting",
36+
"theme": {
37+
"footer": false
38+
}
3339
}
3440
}
3541

pages/it-crafting.mdx

Lines changed: 110 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,110 @@
1+
---
2+
title: "it-crafting"
3+
description: "Easy to use advanced Crafting-System! Ready for every big FiveM Framework"
4+
---
5+
6+
import YouTube from '@components/YouTube'
7+
import ExternLink from '@components/ExternLink'
8+
9+
[![Crafting Banner](https://i.imgur.com/8bJSAW7.png)](https://github.com/it-scripts/it-crafting?tab=readme-ov-file#it-crafting "Go to repo")
10+
11+
it-crafting is a lightweight crafting system for FiveM servers. Originally used as a part of the it-drugs script it has been separated into its own resource to allow for more customization and flexibility. The script comes with a fully configurable crafting system that allows players to craft items using raw materials. The script is easy to install and configure, making it a great addition to any FiveM server.
12+
13+
### Supported Frameworks
14+
- `` **| [ESX](https://github.com/esx-framework/esx_core)**
15+
- `` **| [QbCore](https://github.com/qbcore-framework/qb-core)**
16+
- `` **| [QBox](https://github.com/Qbox-project/qbx_core)**
17+
18+
### Suported Inventorys
19+
- `` **| [esx_inventory](https://github.com/esx-framework/esx_core)**
20+
- `` **| [qb_inventory](https://github.com/qbcore-framework/qb-inventory)**
21+
- `` **| [ox_inventory](https://github.com/overextended/ox_inventory)**
22+
- `` **| [qs_inventory](https://www.quasar-store.com/de/package/6304046?image=0)**
23+
- `` **| [mInventory](https://codem.tebex.io/package/5900973)**
24+
25+
`` **| Supported** `🔧` **| Pending** `` **| Not Supported**
26+
27+
### Dependencys
28+
- `⚙️` **| [ox_lib](https://github.com/overextended/ox_lib)**
29+
- `⚙️` **| [oxmysql](https://github.com/overextended/oxmysql)**
30+
- `⚙️` **| [ox_target](https://github.com/overextended/ox_target)** *
31+
- ~~`⚙️` **| [qb-target](https://github.com/qbcore-framework/qb-target)** *~~ (The script currently does not work with qb-target)
32+
33+
* Optional
34+
35+
<div align="center">
36+
37+
![Crafting Features Banner](https://i.imgur.com/YpH9qFq.png)
38+
39+
</div>
40+
41+
### `📍` **| Fixed Possitions**
42+
Our script offers fixed crafting positions that allow players to craft items at specific locations.
43+
Players can interact with these positions to access the crafting menu and create new items.
44+
The fixed positions make it easy for players to find the crafting locations and create items without any hassle. The positions can be configured in the config file, allowing server admins to customize the crafting experience to fit their unique needs.
45+
46+
### `🔨` **| Crafting Tables**
47+
Our script features crafting tables that allow players to transform raw materials into high-value items. Players can use these tables to craft items themselves, adding a layer of complexity to the crafting system. The Tables can be placed anywhere on the map, making it easy for players to craft their materials and create new items. Every table can be configured in the config file, allowing server admins to customize the experience to fit their unique needs.
48+
49+
### `📊` **| Ingame Admin Menu**
50+
Our script features an ingame admin menu that allows server admins to manage drugs and tables. Admins can use the menu view and manage all drugs and tables on the server, making it easy to keep track of everything. The admin menu can be accessed by typing `/crafting` in the chat.
51+
52+
### `🔧` **| Fully Configurable**
53+
Our script is fully configurable, allowing server admins to customize every aspect to fit their unique needs. The config file contains a wide range of options that can be adjusted to change the crafting system's behavior. Server admins can configure the crafting tables, crafting positions, crafting recipes, and more, making it easy to create a unique experience for players.
54+
55+
<div align="center">
56+
57+
[![Crafting Documentation Banner](https://i.imgur.com/Er2hqzn.png)](https://docs.it-scripts.com/)
58+
59+
## Documentation
60+
<ExternLink href="https://docs.it-scripts.com/it-crafting"></ExternLink>
61+
<br/>
62+
</div>
63+
64+
<div align="center">
65+
66+
[![Crafting Preview Banner](https://i.imgur.com/Ap8LwL5.png)](https://docs.it-scripts.com/)
67+
<br/>
68+
</div>
69+
70+
71+
<div align="center">
72+
73+
[![Crafting Schowcase Banner](https://i.imgur.com/ECheb1f.png)](https://www.youtube.com)
74+
## Comming soon
75+
76+
</div>
77+
78+
<br/>
79+
<table>
80+
<tbody>
81+
<tr>
82+
<td>
83+
<h4 align='center'>Legal Notices</h4>
84+
</td>
85+
</tr>
86+
<tr>
87+
<td>
88+
it-crafting (it-scripts)
89+
90+
Copyright (C) 2024 [it-scripts](https://github.com/it-scripts)
91+
92+
This program is free software: you can redistribute it and/or modify
93+
it under the terms of the GNU General Public License as published by
94+
the Free Software Foundation, either version 3 of the License, or
95+
(at your option) any later version.
96+
97+
98+
This program is distributed in the hope that it will be useful,
99+
but WITHOUT ANY WARRANTY; without even the implied warranty of
100+
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
101+
GNU General Public License for more details.
102+
103+
104+
You should have received a copy of the GNU General Public License
105+
along with this program.
106+
If not, see https://www.gnu.org/licenses/
107+
</td>
108+
</tr>
109+
</tbody>
110+
</table>

pages/it-crafting/_category_.yml

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
collapsible: true
2+
collapsed: true
3+
link:
4+
type: generated-index
5+
description: Easy to use advanced Crafting-System! Ready for every big FiveM framework

pages/it-crafting/_meta.json

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
{
2+
"installation": {
3+
"title": "📥・Installation",
4+
"theme": {
5+
"footer": false
6+
}
7+
},
8+
"adjustments": "⚙️・Adjustments",
9+
"tipps-and-tricks": "😀・Tipps and Tricks",
10+
"common-errors": {
11+
"title": "❓・Common Errors",
12+
"theme": {
13+
"footer": false
14+
}
15+
}
16+
}
17+
Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
{
2+
"zones": {
3+
"title": "🗺️・Zones",
4+
"theme": {
5+
"footer": false
6+
}
7+
},
8+
"recipes": {
9+
"title": "📜・Recipes",
10+
"theme": {
11+
"footer": false
12+
}
13+
},
14+
"crafting-points": {
15+
"title": "📍・Crafting Points",
16+
"theme": {
17+
"footer": false
18+
}
19+
},
20+
"crafting-tables": {
21+
"title": "⚙️・Crafting Tables",
22+
"theme": {
23+
"footer": false
24+
}
25+
}
26+
}
Lines changed: 131 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,131 @@
1+
---
2+
title: it-crafting - Crafting Points
3+
description: So let's start setting up the Crafting Tables.
4+
---
5+
6+
import {Tabs} from 'nextra/components'
7+
import ExternLink from '@components/ExternLink'
8+
import Accordion from '@components/Accordion'
9+
import AccordionGroup from '@components/AccordionGroup'
10+
import { IconExternalLink } from '@tabler/icons-react'; // Importiere das Tabler-Icon
11+
import { Callout } from '@components/Callout'
12+
13+
# 📍・Crafting Points
14+
So let's start setting up the crafting points. Crafting points are static points where the player can craft items.
15+
16+
## Config.CraftingPoints
17+
The individual processing points can now be configured here:
18+
19+
```lua
20+
['crafting_point_one'] = {
21+
zone = vector3(2.0, 1.0, 2.0),
22+
label = 'Crafting Point', -- Label for the table
23+
model = 'v_res_tre_table2', -- Exanples: freeze_it-scripts_empty_table, freeze_it-scripts_weed_table, freeze_it-scripts_coke_table, freeze_it-scripts_meth_table
24+
restricCrafting = {
25+
['onlyOnePlayer'] = true, -- Only one player can use the table at a time
26+
['onlyOwnerCraft'] = false, -- Only the owner of the table can use it
27+
['onlyOwnerRemove'] = true, -- Only the owner of the table can remove it
28+
['zones'] = {}, -- Zones where the table can be used
29+
['jobs'] = {}
30+
},
31+
blip = {
32+
display = true, -- Display blip on map
33+
sprite = 446, -- Select blip from (https://docs.fivem.net/docs/game-references/blips/)
34+
displayColor = 2, -- Select blip color from (https://docs.fivem.net/docs/game-references/blips/)
35+
displayText = 'Crafting Table',
36+
},
37+
recipes = {
38+
-- Here you can add as many recipes as you want
39+
}
40+
}
41+
```
42+
43+
```lua
44+
['crafting_point_one']
45+
```
46+
This is the name of the item to which this configuration is bound. The item can now be used to set up a table in the game.
47+
48+
---
49+
50+
```lua
51+
zone = vector3(2.0, 1.0, 2.0),
52+
```
53+
As soon as the player places the table, the script will create a zone around the table. The zone is used to interact with the table.
54+
The zone has to be defined as a vector3. The first value is the width, the second value is the length, and the third value is the height of the zone.
55+
56+
```lua
57+
model = 'v_res_tre_table2'
58+
```
59+
The model of the processing table here can theoretically be used with any Fivem model.
60+
You also can set the model to `nil` if you dont want to use a model.
61+
Then the script will only create a zone at the position.
62+
63+
---
64+
65+
```lua
66+
restricCrafting = {
67+
['onlyOnePlayer'] = true, -- Only one player can use the table at a time
68+
['onlyOwnerCraft'] = false, -- Only the owner of the table can use it
69+
['onlyOwnerRemove'] = true, -- Only the owner of the table can remove it
70+
['jobs'] = {}
71+
},
72+
```
73+
74+
- `onlyOnePlayer` - As the name suggests, only one player can use the table at a time.
75+
- `onlyOwnerCraft` - Only the owner of the table can use the table.
76+
- `onlyOwnerRemove` - Only the owner of the table can remove the table.
77+
- `jobs` - Jobs that can use the table.
78+
- If you want to allow all jobs to use the table, you can leave the table empty.
79+
- If you want to add a job, you can add the job name to the table like this: `['police'] = true`. Now only the police can use the table.
80+
You also hove the option to add a job with a specific grade like this: `['police'] = {1, 2}`. Now only the police with the grade 1 and 2 can use the table.
81+
82+
---
83+
84+
```lua
85+
blip = {
86+
display = true, -- Display blip on map
87+
scale = 1.0, -- Blip scale
88+
sprite = 446, -- Select blip from (https://docs.fivem.net/docs/game-references/blips/)
89+
displayColor = 2, -- Select blip color from (https://docs.fivem.net/docs/game-references/blips/)
90+
displayText = 'Crafting Point',
91+
},
92+
```
93+
The blip of the point can be set here.
94+
If set to `true`, the blip will be displayed on the map to all players.
95+
96+
97+
### Recipes
98+
Each table can theoretically have an infinite number of recipes, how exactly a recipe must look is explained here
99+
<ExternLink
100+
href="https://docs.it-scripts.com/it-crafting/adjustments/recipes"
101+
/>
102+
103+
104+
---
105+
<AccordionGroup>
106+
<Accordion title="Crafting point configuration template">
107+
```lua copy
108+
['simple_crafting_point'] = {
109+
zone = vector3(2.0, 1.0, 2.0),
110+
label = 'Weed Processing Table', -- Label for the table
111+
model = 'v_res_tre_table2', -- Exanples: freeze_it-scripts_empty_table, freeze_it-scripts_weed_table, freeze_it-scripts_coke_table, freeze_it-scripts_meth_table
112+
restricCrafting = {
113+
['onlyOnePlayer'] = true, -- Only one player can use the table at a time
114+
['onlyOwnerCraft'] = false, -- Only the owner of the table can use it
115+
['onlyOwnerRemove'] = true, -- Only the owner of the table can remove it
116+
['jobs'] = {}
117+
},
118+
blip = {
119+
display = true, -- Display blip on map
120+
sprite = 446, -- Select blip from (https://docs.fivem.net/docs/game-references/blips/)
121+
displayColor = 2, -- Select blip color from (https://docs.fivem.net/docs/game-references/blips/)
122+
displayText = 'Crafting Table',
123+
},
124+
recipes = {
125+
-- Here you can add as many recipes as you want
126+
}
127+
}
128+
```
129+
</Accordion>
130+
</AccordionGroup>
131+

0 commit comments

Comments
 (0)