Merge branch 'master' into 'master'

report-Thomas-Bouvencourt-42341900.md

See merge request ldricot/lingi2401!380

projects/projects_2024-25/report-Thomas-Bouvencourt-42341900.md

+# 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.
+
+![Texte alternatif](imgs_thomas/first_cata.png "Titre facultatif")
+
+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.
+
+![Texte alternatif](imgs_thomas/first_good_issue.png "Titre facultatif")
+
+### 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.
+
+![Texte alternatif](imgs_thomas/1qgis.png "Titre facultatif")
+
+![Texte alternatif](imgs_thomas/2qgis.png "Titre facultatif")
+
+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.
+
+![Discord Discussion](imgs_thomas/1mod.png)
+
+### 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:
+
+![Discord Discussion](imgs_thomas/pulv.png)
+
+The changement i made (from white to color) : 
+
+![Discord Discussion](imgs_thomas/pulv.to.png)
+
+
+#### 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.
+
+![Discord Discussion](imgs_thomas/2mod.png)
+
+
+---
+
+### 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)