diff --git a/projects/projects_2024-25/imgs_thomas/1mod.png b/projects/projects_2024-25/imgs_thomas/1mod.png new file mode 100644 index 0000000000000000000000000000000000000000..33d2b47da1d6a25cf75aed59bcd7b024f9ee22d2 Binary files /dev/null and b/projects/projects_2024-25/imgs_thomas/1mod.png differ diff --git a/projects/projects_2024-25/imgs_thomas/1qgis.png b/projects/projects_2024-25/imgs_thomas/1qgis.png new file mode 100644 index 0000000000000000000000000000000000000000..b2c6bf56b658e44be089eaf31f13f0b79e2cc78d Binary files /dev/null and b/projects/projects_2024-25/imgs_thomas/1qgis.png differ diff --git a/projects/projects_2024-25/imgs_thomas/2mod.png b/projects/projects_2024-25/imgs_thomas/2mod.png new file mode 100644 index 0000000000000000000000000000000000000000..8f29871eed368ab607e33c13f275a7f994c1c2db Binary files /dev/null and b/projects/projects_2024-25/imgs_thomas/2mod.png differ diff --git a/projects/projects_2024-25/imgs_thomas/2qgis.png b/projects/projects_2024-25/imgs_thomas/2qgis.png new file mode 100644 index 0000000000000000000000000000000000000000..42a9846e934d6d09ef79fbe3d750d443fae74bff Binary files /dev/null and b/projects/projects_2024-25/imgs_thomas/2qgis.png differ diff --git a/projects/projects_2024-25/imgs_thomas/first_cata.png b/projects/projects_2024-25/imgs_thomas/first_cata.png new file mode 100644 index 0000000000000000000000000000000000000000..64cad29415e3148c133441a6edf9919f17c8fd38 Binary files /dev/null and b/projects/projects_2024-25/imgs_thomas/first_cata.png differ diff --git a/projects/projects_2024-25/imgs_thomas/first_good_issue.png b/projects/projects_2024-25/imgs_thomas/first_good_issue.png new file mode 100644 index 0000000000000000000000000000000000000000..bf761f119c619749b7c960a451abf937bb5cff46 Binary files /dev/null and b/projects/projects_2024-25/imgs_thomas/first_good_issue.png differ diff --git a/projects/projects_2024-25/imgs_thomas/pulv.png b/projects/projects_2024-25/imgs_thomas/pulv.png new file mode 100644 index 0000000000000000000000000000000000000000..6ca3a66b0f6362c8948f85393548032fede6301a Binary files /dev/null and b/projects/projects_2024-25/imgs_thomas/pulv.png differ diff --git a/projects/projects_2024-25/imgs_thomas/pulv.to.png b/projects/projects_2024-25/imgs_thomas/pulv.to.png new file mode 100644 index 0000000000000000000000000000000000000000..975ef303bc03675d0014f5e411b86c3f874be90d Binary files /dev/null and b/projects/projects_2024-25/imgs_thomas/pulv.to.png differ diff --git a/projects/projects_2024-25/report-Thomas-Bouvencourt-42341900.md b/projects/projects_2024-25/report-Thomas-Bouvencourt-42341900.md new file mode 100644 index 0000000000000000000000000000000000000000..3da950782b09f92465bcfdbd27cb42172e95304d --- /dev/null +++ b/projects/projects_2024-25/report-Thomas-Bouvencourt-42341900.md @@ -0,0 +1,149 @@ +# How I Found a Project + +This is my first experience contributing to an open-source project. As part of the course, we were free to choose any project to contribute to. + +## A Few Attempts, But Not Always a Good Idea + +### First Attempt + +I initially decided to focus on finding an open-source game project to contribute to, as I am passionate about video games. I spent several days browsing lists of open-source games and found several manageable projects, such as: + +- Solitaire game +- Poker game +- Survival game [Cataclysm-DDA](https://github.com/CleverRaven/Cataclysm-DDA) + +I chose **Cataclysm-DDA**, a survival game, and joined their Discord community. + + + +I spent weeks trying to find an issue I could work on. However, the language (C++) and the game itself, which I had never played, posed significant challenges. + +I asked the community for guidance and was directed to a simpler task. However, Despite the help, I still struggled and felt limited by the available translation tasks, which didn't interest me. + + + +### Second Attempt + +I then decided to explore another project: **QGIS** [QGIS GitHub](https://github.com/qgis/QGIS), a popular open-source geospatial software. A friend of mine uses it and I noticed it had many bugs to be fixed. + +To get started, I subscribed to the Belgian and Development mailing lists and joined an unofficial Discord server. I reached out to the community to explore opportunities for contributing, whether by reporting bugs, improving documentation, or suggesting improvements. I received encouraging feedback, which motivated me to stay engaged. + + + + + +However, after gathering enough information and following the developer mailing list for a while, I found the project's complexity overwhelming. I realized I needed to find a project I was more familiar with and passionate about. + +--- + +# A Brief Description of the Project + +| Author | Bouvencourt Thomas | +|---------------|---------------------| +| NOMA | 42341900 | +| Academic Year | 2024 - 2025 | +| GitHub Project| [Oritech](https://github.com/Rearth/Oritech) | +| License | CC0 1.0 Universal | +| Pull Request | https://github.com/Rearth/Oritech/pull/184 | + +### Project Description + +**Oritech** is an open-source tech mod for **Minecraft 1.21**, offering new machines and tools. It includes processing machines, world interaction machines, logistical parts, new world generation features, and more. Machines are mostly animated multiblocks, and upgrades are implemented via addon blocks. + +**GitHub Description:** +An upcoming tech mod for Minecraft Fabric. Features advanced ore processing, powered tools, armor, and more. + +- Wiki available [here](https://moddedmc.org/en/mod/oritech/docs) +- Currently in early access, bugs and issues expected. +- If you want to contribute or suggest ideas, check out the [GitHub discussions](https://github.com/Rearth/Oritech/discussions). + +### Motivation + +I chose this project because I am passionate about **Minecraft** and have enjoyed exploring its mods. I have experience creating my own small mods, and I wanted to apply my skills while learning more about modding. Additionally, contributing to a project that has provided me with countless hours of entertainment felt like an excellent opportunity. + +--- + +### First Contact with the Dev Community + +To get started, I introduced myself on the **Oritech Discord** [link](https://discord.gg/xqP76HN6), expressing my interest in contributing and asking for beginner-friendly tasks. The community responded positively, offering guidance and pointing me toward useful resources. + + + +### Setting Up and Exploring + +- **Environment Setup:** + I downloaded the source code, configured the development environment (Gradle, IntelliJ IDEA, Java SDK), and successfully built the mod locally. + +- **Finding a Task:** + I explored open issues and found one that seemed suitable for my skills. + +--- + +### The Contribution + +#### First Contribution: Fixing Dye Recipes + +My first contribution was fixing an issue where all pulverizer dye recipes produced white dye instead of the intended colors. The issue was described as follows: + +- **Issue:** All pulverizer dye recipes were giving white dye instead of the correct color. +- **Steps to reproduce:** Check recipes in the recipe viewer. +- **Minecraft Version:** 1.21.1 +- **Platform:** Neoforge +- **Loader Version:** 21.1.81 +- **Fabric API Version:** N/A +- **Oritech Version:** 0.12 + +#### Steps Taken: +1. **Identifying the Problem:** + I examined the pulverizer dye recipes in the code and found that the color values were not assigned correctly. + +2. **Fixing the Recipes:** + I updated the recipe files to use the correct color values for the dyes. + +3. **Testing:** + After making the changes, I tested the recipes in Minecraft to confirm the correct dyes were being produced. + +4. **Pull Request:** + I submitted a pull request with a detailed explanation of the issue, the solution, and testing results. The PR was reviewed and merged successfully. [https://github.com/Rearth/Oritech/pull/184] + + +Here’s a detailed view: +A pulverizer is a machine like this: + + + +The changement i made (from white to color) : + + + + +#### Second Contribution: Fixing Gradle Build Configuration + +My second contribution involved fixing issues with the **Gradle build configuration** in **IntelliJ**. Some parameters were incorrect, which caused build issues. I identified the misconfigurations and proposed fixes to ensure the build process ran smoothly. + +Although I submitted a pull request, it is still under review. I am currently discussing the changes with the mod creator to ensure the solution is optimal. + +#### Redesigning the Dubious Container +Currently, I am working on redesigning the Dubious Container in the mod. The goal is to improve its visual appearance and functionality to enhance the user experience. I'm collaborating with the mod creator to ensure that the new design aligns with the overall theme and mechanics of the mod. This task involves both UI/UX improvements and adjusting the model's visuals to make it more intuitive and visually appealing. + + + + +--- + +### Conclusion + +Contributing to **Oritech** has been an enriching experience. This project has been much more than just a coursework requirement for me. It has an interest in open-source development and modding, and I am excited about the potential to contribute further in this mod. Working on Oritech has deepened my connection to both the game and its community. Even after completing the initial tasks, I continue to actively work on the mod, with plans to contribute even more in the future. The experience has motivated me to keep learning, improve my skills, and stay involved in the project long-term, as I am passionate about helping it grow and succeed. + + + Maybe one day, I will create my own mod. + + +--- + + +### **Sources** + +- **Translation Assistance:** ChatGPT +- **GitHub Project:** [Oritech Repository](https://github.com/Rearth/Oritech) +- **Mod Information:** [Oritech on CurseForge](https://www.curseforge.com/minecraft/mc-mods/oritech)