diff --git a/.wordlist.txt b/.wordlist.txt index c10f1172..3391872f 100644 --- a/.wordlist.txt +++ b/.wordlist.txt @@ -174,6 +174,7 @@ globals GLSL glTF glyphs +GML goeshard GPU GPUs @@ -454,6 +455,7 @@ tilesources timestep TinyHTTP TLS +toc toolset tooltip tooltips @@ -474,6 +476,7 @@ tweening tweens txt UASTC +Udemy UDID UDP UHD @@ -536,6 +539,7 @@ xcode yaml yml xy +Zenva ZeroBrane ZeroBrane's zig diff --git a/docs/en/manuals/images/building_blocks/building_blocks.png b/docs/en/manuals/images/building_blocks/building_blocks.png index cf559cf8..b5e3e70f 100644 Binary files a/docs/en/manuals/images/building_blocks/building_blocks.png and b/docs/en/manuals/images/building_blocks/building_blocks.png differ diff --git a/docs/en/manuals/images/building_blocks/building_blocks@2x.png b/docs/en/manuals/images/building_blocks/building_blocks@2x.png deleted file mode 100644 index bfb5c3cb..00000000 Binary files a/docs/en/manuals/images/building_blocks/building_blocks@2x.png and /dev/null differ diff --git a/docs/en/manuals/images/introduction/building_blocks.png b/docs/en/manuals/images/introduction/building_blocks.png deleted file mode 100644 index 27ce070a..00000000 Binary files a/docs/en/manuals/images/introduction/building_blocks.png and /dev/null differ diff --git a/docs/en/manuals/images/introduction/editor.png b/docs/en/manuals/images/introduction/editor.png deleted file mode 100644 index fd89dbd5..00000000 Binary files a/docs/en/manuals/images/introduction/editor.png and /dev/null differ diff --git a/docs/en/manuals/images/introduction/examples.jpg b/docs/en/manuals/images/introduction/examples.jpg deleted file mode 100644 index 8b74d231..00000000 Binary files a/docs/en/manuals/images/introduction/examples.jpg and /dev/null differ diff --git a/docs/en/manuals/images/introduction/examples.png b/docs/en/manuals/images/introduction/examples.png new file mode 100644 index 00000000..d9174938 Binary files /dev/null and b/docs/en/manuals/images/introduction/examples.png differ diff --git a/docs/en/manuals/images/introduction/forum.jpg b/docs/en/manuals/images/introduction/forum.jpg deleted file mode 100644 index 888609f9..00000000 Binary files a/docs/en/manuals/images/introduction/forum.jpg and /dev/null differ diff --git a/docs/en/manuals/images/introduction/forum.png b/docs/en/manuals/images/introduction/forum.png new file mode 100644 index 00000000..d4f98a9a Binary files /dev/null and b/docs/en/manuals/images/introduction/forum.png differ diff --git a/docs/en/manuals/images/introduction/introduction_factory.png b/docs/en/manuals/images/introduction/introduction_factory.png index 13463afe..9eef59f8 100644 Binary files a/docs/en/manuals/images/introduction/introduction_factory.png and b/docs/en/manuals/images/introduction/introduction_factory.png differ diff --git a/docs/en/manuals/images/introduction/introduction_particles.png b/docs/en/manuals/images/introduction/introduction_particles.png index 3d70e21c..4ea5c1d1 100644 Binary files a/docs/en/manuals/images/introduction/introduction_particles.png and b/docs/en/manuals/images/introduction/introduction_particles.png differ diff --git a/docs/en/manuals/images/introduction/lua.png b/docs/en/manuals/images/introduction/lua.png index 8b6593e9..9e79c4b6 100644 Binary files a/docs/en/manuals/images/introduction/lua.png and b/docs/en/manuals/images/introduction/lua.png differ diff --git a/docs/en/manuals/images/introduction/tutorials.jpg b/docs/en/manuals/images/introduction/tutorials.jpg deleted file mode 100644 index 8876ab37..00000000 Binary files a/docs/en/manuals/images/introduction/tutorials.jpg and /dev/null differ diff --git a/docs/en/manuals/images/introduction/tutorials.png b/docs/en/manuals/images/introduction/tutorials.png new file mode 100644 index 00000000..aaf36a24 Binary files /dev/null and b/docs/en/manuals/images/introduction/tutorials.png differ diff --git a/docs/en/manuals/introduction.md b/docs/en/manuals/introduction.md index 71026d54..2eebf3c5 100644 --- a/docs/en/manuals/introduction.md +++ b/docs/en/manuals/introduction.md @@ -1,36 +1,74 @@ --- +brief: A brief introduction to Defold. This is a great place to start your adventure with game development and Defold. +github: https://github.com/defold/doc +layout: manual +locale: en title: Introduction to Defold -brief: A brief introduction to Defold. +toc: +- Welcome to Defold +- Where to start? --- -# Welcome to Defold +## Welcome to Defold -Defold is a turn-key solution, providing everything you need to design, build and ship games. The full list of supported features can be seen in our [Product Overview](/product). +Defold is a free, lightweight, and high-performance turnkey solution for the development of 2D and 3D games - a game engine, editor, and building ecosystem in one box, providing everything you need to design, build, and ship. The full list of supported features can be seen in our [Product Overview](/product). -We have spent a lot of time and effort making sure that certain key elements of the game development process are as smooth and effortless as possible and we believe it makes Defold stand out from the crowd. Learn [why we think you should use Defold here](/why). +We have spent a lot of time and effort making sure that certain key elements of the game development process are as smooth and effortless as possible, and we believe it makes Defold stand out from the crowd. Learn [why we think you should use Defold](/why). ## Where to start? -We encourage you to experiment, follow tutorials, read our manuals and API documentation, and to be active on the forum to learn from other users and follow the development of Defold. There is quite a lot of documentation available, in the form of manuals, API reference documentation, examples and tutorials. If you don't know where to start, here are some pointers: +Our [**Learning Hub**](/learn) is a starting point for all learning resources for Defold. You'll find there: -#### The editor -![Editor overview](images/introduction/editor.png){.left} [The editor overview](/manuals/editor/) gives a good introduction to the editor and will help you get around, use the visual tools and write code. If you are familiar with 3D modelling programs and programming IDEs, there should be few surprises, but there are always things that will be different from your favorite piece of software. +- [**Manuals**](/manuals) (like this one) - to deeply understand a given topic and broaden your knowledge +- [**Tutorials**](/tutorials) - to create something by following guided step-by-step instructions +- [**Examples**](/examples) - short snippets of code and simple, small, contained functionalities and samples +- [**Courses**](/courses) - longer-form, comprehensive, structured lessons on Zenva, Udemy, and created by the community +- [**Videos**](/videos) - if you prefer watching, there are a lot of video tutorials and overviews to choose from +- [**API**](/ref/stable/overview_defoldlua) - understand all the provided functions and constants with our up-to-date full documentation +- [**FAQ**](/faq/faq) - with answers to the most frequently asked questions - search to see if maybe your issue was already solved -#### Simple examples -![Examples](images/introduction/examples.jpg){.left} [Our collection of simple examples](/examples/) is a good introduction to how to put pieces together into something that works. You will find minimal examples of how to do a wide variety of common things in Defold. +We encourage you to experiment, follow tutorials, read our manuals and API documentation, and join our [community channels](/community) - to ask questions, learn from other users, and follow the development of Defold. -#### The Lua language -![Lua overview](images/introduction/lua.png){.left} [Defold uses Lua](/manuals/lua/) for all its logic control. The engine is a fast C++ piece of machinery, but it is controlled on a high level by Lua programs. If you have programmed in Python, Javascript or any other high level language, you will find Lua pretty easy to grasp and can probably follow along a tutorial just fine. Otherwise, read through our Lua manual and take it from there. +Here are some good-to-know pointers when starting your game development journey or learning Defold: -#### Game tutorials -![Tutorials](images/introduction/tutorials.jpg){.left} We believe that you learn best by doing. That is why we have a selection of tutorials at various skill and complexity level available directly from [the editor](/manuals/editor/). Fire it up and follow one or two of the tutorials to learn how to build things and how Defold works. +### Defold Editor -#### The building blocks of Defold -![Building blocks](images/introduction/building_blocks.png){.left} [Defold games are built by composing simple blocks](/manuals/building-blocks/), some of which seem familiar if you have used other engines. There are some architectural design decisions that make the blocks of Defold special and it takes a little while to be comfortable working with them. Our building blocks manual is a good start if you feel you need to understand thoroughly how it's working. +[![Editor overview](images/editor/editor_overview.png)](/manuals/editor) -#### The forum -![Forum](images/introduction/forum.jpg){.left} [Learning from others](//forum.defold.com/) is often the best way to learn. Our community is very friendly and knows a lot about building games in general and Defold in particular. If you ever get stuck, don't hesitate but head over to the forum for help! +[The Editor Overview](/manuals/editor/) gives a good introduction to it and will help you get around, use the visual tools, and write code. If you are familiar with other game engines' editors, 3D modelling programs, and programming IDEs, there shouldn't be many surprises, but there are always things that will be different from your favorite piece of software. -Remember that no matter what path you take to learning Defold, you can always come back here for in-depth explanations of the various features and concepts Defold provides. And don't hesitate to point out things that you do not understand or think are wrong. These pages are for you and we want to make them as good as possible. +### The building blocks of Defold -We hope that you will enjoy creating your next awesome game in Defold! +[![Building blocks](images/building_blocks/building_blocks.png)](/manuals/building-blocks) + +[Defold Building Blocks](/manuals/building-blocks/) is a great introductory manual about the fundamental core concepts of game development in Defold. Defold uses game objects with multiple different kinds of components for building games, and game objects are then grouped into collections. These might seem familiar if you have used other engines before. There are some architectural design decisions that make the building blocks of Defold special, and it takes a moment to become comfortable working with them. Therefore, our building blocks manual is a good start, especially if you feel you need to understand how it works. + +### Examples + +[![Examples](images/introduction/examples.png)](/examples) + +[Examples](/examples/) collection is a good introduction to how to put pieces together into something that works. You will find there minimal examples of how to do a wide variety of common things in Defold, code snippets to use, samples of some common functionalities, and showcases of certain features. + +### Tutorials + +[![Tutorials](images/introduction/tutorials.png)](/tutorials) + +[Tutorials](/tutorials) are great for starting your game development journey. We believe that you learn best by doing. That is why we have a selection of tutorials at various skill and complexity levels available directly from [the editor](/manuals/editor/) and in our learning hub. Fire it up and follow step-by-step instructions to learn how to build things and how Defold works. + +### The Lua language + +[![Lua overview](images/introduction/lua.png)](/manuals/lua) + +[Lua](/manuals/lua/) is the language used in Defold for all its logic control. The engine internally is a fast C++ piece of machinery, but it is controlled at a high level by Lua scripts. If you have programmed in Python, GDScript, GML, Javascript, or any other high-level language, you will find Lua pretty easy to grasp and can probably follow along with a tutorial just fine. Otherwise, read through our Lua manual and take it from there. + +### The Defold Forum + +[![Forum](images/introduction/forum.png)](//forum.defold.com/) + +[The Defold Forum](//forum.defold.com/) is often the best way to learn - you can learn from others, search the forum to find whether your issue was answered in the past, or ask directly. Our community is very friendly, helpful, and knows a lot about building games in general and Defold in particular. If you ever get stuck, don't hesitate, but head over to the forum for help! + +### Learning Hub + +Remember that no matter what path you take to learning Defold, you can always come back to our [**Learning Hub**](/learn) to find any other learning resources and read manuals for in-depth explanations of the various features and concepts Defold provides. And don't hesitate to point out things that you do not understand or think are wrong. These pages are for you, and we want to make them as good as possible, so we take users' feedback into account and try to improve the resources to make the learning curve as smooth as possible! + +We hope that you will enjoy creating your next awesome game in Defold! \ No newline at end of file