MATLAB Mechanical System Simulation

I’m looking to build a clear, well-documented MATLAB simulation that captures the behavior of a mechanical system from first principles. The work is simulation-focused—no data analysis or algorithm research—so every effort goes into translating the governing equations into an executable model that I can run, tweak, and extend later.

Here’s what I have in mind: the system’s dynamics will be coded in MATLAB (plain .m scripts, Simulink, or a mix of both if that proves cleaner). I’d like the model to accept key physical parameters as inputs, solve the differential equations with an appropriate solver such as ODE45 or its stiff counterparts, and then generate intuitive visual outputs—plots of displacement, velocity, energy, or an animation if practical.

Please organise the work so that:

• All source files run without additional toolboxes beyond the MATLAB base and Simulink if you choose to use it.
• Functions or blocks are commented clearly enough that I can change masses, damping, or external forces and instantly rerun.
• A short read-me explains setup, variable naming, and any peculiar assumptions.

The simulation is considered complete when it reproduces the expected mechanical response for at least one test case we agree on and the code remains stable under a few parameter variations.

If you need clarifications on boundary conditions, numerical methods, or preferred plotting styles, just let me know—I can supply the physical parameters or example scenarios as soon as we connect.