You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/beginner's-guide-to-qodot/building-maps.md
+34-15Lines changed: 34 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,38 +5,57 @@ nav_order: 4
5
5
parent: Beginner's Guide to Qodot
6
6
---
7
7
8
+
{:toc}
9
+
10
+
If you don't have any map files or textures, and want to fully setup your Godot project with your Trenchboom editor, read the page on [Trenchbroom Setup](qodotplugin.github.io/docs/beginner's-guide-to-qodot/trenchbroom-setup.html) first. Otherwise, continue reading.
11
+
8
12
# Building Maps
9
13
10
-
Assuming your map fits the list of supported .map formats, and has limited entities, this is the fastest way to get your map into Godot.
14
+
## Building Basic Geometry
11
15
12
-
- Add a .map file to your Godot project directory.
16
+
-With the plugin [installed and enabled](https://qodotplugin.github.io/docs/beginner's-guide-to-qodot/), Add a .map file to your project. It will import as a visible resource in your FileSystem dock.
13
17
14
18

15
19
16
-
- Load it up from a QodotMap node.
20
+
- Add a QodotMap node from the *Add Node* menu, or press <kbd>Ctrl</kbd> + <kbd>A</kbd> and type "QodotMap".
21
+
22
+
- Select QodotMap, then go to the Inspector. Click the folder icon in the *Map File* property and choose your map file.
17
23
18
24

19
25
20
-
- Hit Full Build in the toolbar.
26
+
- Hit Full Build in the toolbar. (If Full Build isn't visible, check you're running the C# build and press <kbd>Alt</kbd> + <kbd>B</kbd>.
21
27
22
28

23
29
24
-
Your map is now in Godot!
30
+
Your map geometry is now in Godot!
25
31
26
32

27
33
28
-
Note
29
-
{: .label .label-blue }
30
-
If you don’t see QodotMap in your nodes list, make sure you have enabled Qodot in the Project → Project Settings -> Plugin window.
34
+
### Build Troubleshooting
35
+
36
+
If your map isn't building, try the following solutions:
37
+
38
+
- Check the console for errors and post a screenshot of your editor window to the community.
39
+
- Check that your map or textures doesn't use spaces or UTF-8 exclusive characters.
40
+
41
+
# Loading Textures
42
+
43
+
This assumes your map already has textures. If you're starting from scratch, and want to unite your Godot project with your Trenchboom editor, read the page on [Trenchbroom Setup](qodotplugin.github.io/docs/beginner's-guide-to-qodot/trenchbroom-setup.html).
44
+
45
+
## Using Loose Textures
46
+
47
+
If your map already has textures, make sure your Godot project has access to the same folder names used in the map. You can copy the map's loose textures into a folder, such as `res://textures`.
48
+
49
+
Then, set *Base Textures Dir* to the folder with your map's loose textures.
If you want to display textures on your map geometry, read [Loading Textures in Trenchbroom](loading-textures.md).
53
+
## Using WADs
33
54
34
-
If you don't have an original map, and you're trying to port a map instead, read the page on [Porting](../porting.md).
55
+
Add a .WAD file to your project. As long as Qodot enabled, it will be imported as a Godot resource. You can check its contents by double clicking the resource in FileSystem to reveal a Dictionary of textures.
35
56
36
-
# Troubleshooting
57
+
Select your QodotMap, then scroll down to *Texture WADS* and add an element to the Array.
37
58
38
-
If your map isn't building, one of the following is probably the case:
- Somewhere in your filepath, there is a space(probably in texture names).
41
-
- Somewhere in your filepath you are using UTF-8 characters
42
-
- You are using different filetypes for your textures that aren't listed as allowed. Go into the QodotMap node, under the section Textures, make sure the field "Texture File Extensions" includes the file extensions for your texture. Not all texture file formats will work, as this is dependent upon what texture files Godot can use, though tga, png and jpeg should all work.
61
+
Drag and drop the .WAD file onto the Array, or click *Load* and pick the .WAD file from the file browser.
0 commit comments